OR
у документации, написанной разрабочиками, есть один недостаток: много лакун и не хватает описания общего видения продукта. как будто для коллеги пишет, а не для постороннего, которому придется долго копаться.
задача техписа - в т.ч. usability этой документации. не только понятный, красивый язык.
мне нравится подход, что свои инструкции нужно тестить.