FAQнутая документация

[akeepaki]

Опыт разработки пользовательской документации привёл меня к выводу, что будущее за FAQ'ами :). Но не простыми, а золотыми =).

По-моему, порядок работ для написания близкой к идеалу документации должен быть такой:

Comments

[iamnik]

Не, камрад, FAQи синоним прошлого века. Будущее за персональными менеджерами.

[akeepaki]

А персональные менеджеры по-твоему откуда будут брать инфу? :)

[iamnik]

Из опыта.

[akeepaki]

Т.е. ты предлагаешь каждому из них садиться, набивать шишки об программу, постоянно трясти других опытных работников? А пришёл новый человек работать таким менеджером и что он сможет? Как он будет работать?

Да он сам не сможет все понять нормально, если нет правильной документации. А фак максимально ускоряет чтение документации и избавляет от необходимости читать сразу всё, а отсылает на нужные статьи по мере возникновения проблем. (да, это делает и оглавление, но по моему опыту, хороший faq в 90% ситуаций решает!)

Опыт позволит лишь расширить базу неохваченных вопросов и дополнять и дополнять общий фак.

[iamnik]

Показателен такой известный фак как Википедия - автор отказался от идеи... дальше гугли.

[akeepaki]

А идея тем не менее работает =) и пока лучше всего прочего, что можно заметить по тому же количеству цитирования вики