• Какую CMS выбрать для ведения документации нескольких проектов?

    Внешняя система по умолчанию ничего не будет переваривать - она покажет 404 и все. По мере нарастания контента это будет большой головной болью (про стартапы я не говорю :) - там мало контента. Кстати, Atlassian со своей Confluence уже сталкивается с такой проблемой именно из-за title в url. Если вы посмотрите (вдумчиво) на их хелпы, то количество 404 уже неприлично большое для 6 версий каждого продукта.

    Что касается велосипеда, то лучше не изобретать. По умолчанию, имя файла должно быть != title. Т.е. должен быть какой-нибудь uniq ID, который не изменятся со временем. Что касаемо wiki-base, y Atlassian было это в свое время, но они почему-то отказались, чем сделали большие проблемы для компаний (в джире есть целый тред по этому поводу). Другое дело, что им пофигу на это, т.к. показатали дохода и так позволяют не парится о существующих процентах пользователей :)

    Что касаемо тех стандартов, о которых я говорю, то там это по умолчанию из коробки. Т.к. title пишется в head html, а название файла - в uri.
  • Какую CMS выбрать для ведения документации нескольких проектов?

    Ваш пример: http://*Ваш_сайт*/xwiki/bin/view/Test+page/%D1%81%... - имеет очень много проблем. При изменении title - любые отправленные ссылки становятся недействительными. С точки хрения принципа переносимости адреса должны быть "content agnostic".
  • Какую CMS выбрать для ведения документации нескольких проектов?

    Это сематнические стандарты разметки. При использовании этих стандартов ВЫ настраиваете все так, как хотите. В их основе: XML, а также готовые "из коробки" xsl преобразования. Как вы измените готовый xsl (дополните его своим преобразованием), то и будет. Т.е. это управление контентом в автоматическом режиме с помощью xslt-скриптов - полная автоматизация.

    При использовании Docbook/XML вы отделяете содержимое и представление. И сосредотачиваетесь на содержимом - текстах, картинках и т.п.. Это называется технология единого источника в технической документации (single sourcing technical documentation) - содержимое имеет семантическую структуру, не связанную с выходным форматом.

    Приведу лишь пример. Очень показательный. Вы, наверное, знаете про ГОСТ (2.x, 19.x, 34.x). Так вот. Многие просто изнывают от требований рамочек, страницек и т.п. Одна из команд сделала xsl преобразование для формирования именно ГОСТовский документов (https://bitbucket.org/Lab50/espd-docbook5/overview). Т.е. их одного источника можете получить ГОСТ, а можете что-то свое (в обычном "вордовском варианте" вы не сможете получить это без полного переформатирования).

    Суть, надеюсь, понятна?
  • В чем написать документацию для последующего распространения в 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 от ГОСТов - отстутсвие четкое СТРУКТУРЫ документа. Т.е. там приведены только рекомендации.