• В чем написать документацию для последующего распространения в HTML?

    Только, если (хотя бы два из):
    - несколько проектов;
    - несколько клиентов и необходимость компоновки (reuse content);
    - несколько форматов вывода;
    - необходимо управление контентом.

    если цель "только для html" и "написать и забыть" - то использование docbook - микроскопом забивать гвозди :)
  • Где посмотреть примеры документирования разработки сайта?

    Sanes: в ваших комментариях я совершенно не вижу экономики (т.е. денег). А они должны быть на первом месте, если, конечно, вам платят за результат, а не за проведенное время за монитором. Хорошо... чтобы немного уточнить мои изначальные вопросы, ответьте сначала (просто для себя), на следующие:
    - требуются фичи A, B, C.
    - документация будут пользоваться H, K, L
    - время на постановку процесса/возможная стоимость - S.

    После того, как подумаете (а лучше напишите у себя и подумаете), можете здесь озвучить. Тогда станет понятно, что советовать или не советовать.

    P.S. Если на ваш общий вопрос люди дают частное решение, то не факт, что оно подходит именно вам. М.б. лучше задать частные вопросы и получить конкретный ответ?
  • Где посмотреть примеры документирования разработки сайта?

    В вашем комментарии нет ничего по сути изначального вопроса и моего ответа на него.

    P.S. Думать я могу что угодно, но это не поможет вам решить ваш изначальный вопрос (если он еще актуален для вас на текущий момент).
  • Есть хоть какая-то польза от ГОСТов?

    ГОСТ - это государственный стандарт. Понятно, что он применим только в РФ. В Штатах (в части документации на ПО, про оборудование не могу сказать) применение стандартов добровольное. И приняты ISO. В частности, ISO 11072, ISO TR 11017, TR 10182, 18019:2003. Основное отличие ISO от ГОСТов - отстутсвие четкое СТРУКТУРЫ документа. Т.е. там приведены только рекомендации.