Calmius

Документация бывает разная. Если "документация" должна представлять собой нечто стандартизованное под определённую категорию пользователей -- которым надо рисовать скриншоты на каждый чих, говорить "а вот для такого-то действия нажать вот эту кнопку и заполнить вот эту форму" -- это действительно марудно, надоедает через час, а через день вызывает желание уволиться.

Но есть и такая, которая не требует разъяснений, калечащих автора, но должна описывать то, что реально существенно. И вот такую документацию как минимум я люблю писать. Не просто не противлюсь, а намеренно регулярно пишу её в том числе и для формулирования собственного представления о том, что сделал, почему, какие реальные тонкости и потенциальные грабли, что сделано не так или не сделано, куда двигаться дальше, и т.д. Возможно, я представляю собой редкое исключение среди программистской братии:) тем более тогда жаль, что это не повсеместно. Сталкиваясь с образцами "творчества" ряда коллег в плане документирования того, что сделано, я регулярно готов их убивать, потому что люди в принципе не понимают, что тем, кто не поработал над этим несколько лет, непонятны самые основы.

К чему весь этот оффтопик -- к тому, что ни Гарольду, ни прошлым Хранителям не надо делать именно документацию для неопределённого круга в виде, понятном для полных чайников, носорогов и прочей неволшебной живности. Но ему полезно сделать это для своих наследников по этой работе, с учётом того, что кого-то из них может точно так же забросить "как кур в ощип" не имея живого наставника. Ума у него для этого должно хватить, времени -- тоже.