раз тут все болеют за пользователей... у кого в документации есть указатели (индексы)?

что это и зачем?

Когда-то в технических книжках в конце был предметный указатель, аналоговая версия Ctrl-F. Может, об этом?

index term

Ещё называется Index Keywords, это ещё со времён CHM формата пришло и до сих пор используется. Это в дополнение к дереву содержания (TOC) - хочешь ищешь в дереве, хочешь поиском, а хочешь по списку терминов и сразу попадаешь в нужный топик по какой-нибудь аббревиатуре.

алфавитный указатель короче, мне такой сфинкс делал сам по умолчанию

Нету третьего варианта: чтобы компания получила прибыль :)

Нужен третий вариант: помочь бизнесу.

Под него, например, подпадает онбординг-документация: ее задача — ускорить введение новых сотрудников в строй, и основной интересант этого процесса все-таки бизнес, а не новые сотрудники.

Я к тому, что документация, конечно, почти всегда адресована каким-то реально существующим и нуждающимся в ней читателям, но они зачастую не единственные и не самые главные выгодоприобретатели.

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

Отказались от индекса в пользу поиска. Не смотрят пользователи в индекс, идут в поле для поиска.

для веба это ожидаемо. docx / pdf не выпускаете?

В PDF только оглавление у нас популярно )

Так ведь оба варианта помогают бизнесу. Один в том, что бизнес может закрыть проект, другой в том что бизнес приобретает выгоду, когда документация помогает читателям.

В целом я с тобой согласен. Этот опрос только проверяет утверждение «Очень часто, практически всегда, документация пишется ради сдачи проекта»

тогда я не согласен с твоей формулировкой «помочь пользователям»

кажется, что ты заложил в нее смысл «дать пользователям ответы на их явно задаваемые вопросы»

а в моем примере про онбординг смысл другой: «донести пользователям ту информацию, которую они, возможно, явно не просили (или даже не знают о ее существовании), но которая должна быть им донесена, чтобы бизнесу стало лучше»

мой тезис в том, что это две довольно разных цели

Вот шкаф. К шкафу прилагается инструкция по сборке.
Вот кровать. К кровати тоже прилагается инструкция.
Открываю инструкцию по сборке шкафа. Собрал быстро по инструкции. Инструкция понятна. Фирма-производитель шкафа молодцы. Позитивное отношение к ним, рекомендации и дальнейшее сотрудничество.
Начинаю собирать кровать. Один желтый листок мутноватого вида, шрифты расплываются, схемы нет. Вся инструкция по сборке - пару предложений. (сразу напишу, что там была непростая кровать, аля-4 ножки, а достаточно сложная конструкция). Инструкция в помойку, открываем гугл. Кровать была собрана. Куча негатива, антирекомендации и полное нежелание покупать мебель от данной фирмы.
Эти два случая вполне себе реальны, которые произошли со мной.
Первая фирма, не просто сдала проект, а пожелала донести  свои ценности не только через продукцию, но и через документацию.
Вторая - сдала проект. Да и кровать оказалась так себе. То есть не только документация гЪ!

Я заложил в неё смысл "что-то иное, чем просто сдать проект и никогда больше не читать эту документацию"

Здравствуйте, подскажите, при работе с госзакачиками (не оборонка) всегда ли нужно придерживаться ГОСТ при оформлении документации. Можно ли оставить содержательную часть как в ГОСТ, а вот оформительскую часть на свое усмотрение.