December 27th, 2004

О документации.

Документация: сочинение на заданную тему. Отлично знаешь предмет, отлично знаешь для кого пишешь, отлично знаешь зачем пишешь.
Но не лежит душа к написанию подобных опусов. Уж и так себя уговаривал, и сяк - все равно не сдвигается процесс с мертвой точки.
Уж и по принципу "хоть как-то" писал... И вдохновения ждал... И "главное нАчать - а потом само пойдет" пробовал (4 страницы в Ворде "начала" лежит). И тезисы составлял...
А воз и ныне там.
Кстати, о сложностях.
Во-первых, труд намечается фундаментальный: страниц на 20.
Во-вторых, пишется это "для своих": подробный и обстоятельный ответ на вопрос "нафига это надо?".
В-третьих, чёткий и конкретный: потому что если налить воды и/или не достаточно ясно изложить мысль, то потом всё равно придется приходить и лично объяснять "А что конкретно я имел в виду".
В-четвертых, хочется самому выдать правильный документ.
В-пятых... Ладно, расколюсь: документ должен быть на английском языке.
Вот бы у всех получалось так доки писать: коротко, про всё, "как для себя" и чтоб легко всё найти можно было...