Как к лучшей версии разрабатывают документы? [закрытый]

Когда возможно, я сохраняю все "необработанные" файлы в текстовом формате (т.е. XML/DocBook, простой текст, ЛАТЕКС) в дополнение к представленному PDFs при управлении версиями версии. Кроме того, я пытаюсь использовать число пересмотра репозитория Подверсии в качестве номера версии для документа.

Если Вы не можете использовать автоматическое число пересмотра (т.е. одним словом документ), я рекомендую использовать дату последнего изменения. Удостоверьтесь, что использовали дату последнего редактирования а не макроса текущей даты, потому что макрос текущей даты заполнит любую дату, которая это - при печати документа который является, вероятно, не, что Вы хотите. Другой способ пойти состоит в том, чтобы, конечно, использовать традиционный возрастающий номер версии, но по моему опыту людям часто нелегко знать, какая версия является последней, только видя число. Люди обычно больше знают о старых датах.

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

WYSIWYG-редакторы (Word, OpenOffice) обычно не видят оснований, почему кто-либо еще должен смешать с их файлами, таким образом найдя редактора, которого может использовать нетехнический пользователь и который дружелюбен по отношению к системе управления версиями, невозможно. Исключение: у мерзавца есть фильтр, который может изучить файлы OpenOffice. Я не уверен, можно ли использовать расширение ключевого слова, все же.

Я предлагаю использовать Wiki и неделя обучения Вашим пользователям, как использовать его. Это решает все Ваши проблемы (некоторый wikis может даже быть проверен в систему управления версиями). Как я сказал в другом сообщении, единственное препятствие состоит в том, что пользователи займут несколько дней для привыкания к идее. После этого они будут любить его.

Как отмеченный Aaorn Digulla, Wiki является прекрасной идеей. Необходимо понять, что единственный способ, которым Вы действительно собираетесь достигнуть того, что Вы хотите, состоит в том, чтобы заново продумать Вашу всю стратегию документа.

Никакое программное обеспечение не собирается устранить проблему несовместимых форматов файла и не бывший способный сравнивать различные версии. Инструменты, которые Вы используете теперь, являются неправильными инструментами для задания. Это будет жестким, неудобным, и возможно дорогим для изменения набора инструментов и образа мыслей, но это - стоимость способности достигнуть того, что Вы хотите, который закончит тем, что оплатил себя 10 сгибов.

Просто вспомните о трудностях, которые Вы испытали первоначально с документами схемы, диаграммами UML и даже чем-то столь же простым как распланировать документ Word. Они работали вплоть до этой точки, и они получили Вас настолько далеко, но единственный реальный путь вперед состоит в том, чтобы идти дальше к инструментам, которые были разработаны для того, в чем Вы нуждаетесь теперь.

Примечание: окончательным решением не могла бы быть Wiki, но это определенно не, что Вы используете теперь, также. Необходимо исследовать немного и испытать несколько вещей.

Клиент TortoiseSVN (Windows) для SVN знает достаточно о, Открывают Office, что, когда Вы спрашиваете это к разности их, после того как это овладело необходимыми версиями, это открывает Office с обоими открытыми документами, показывая различия. Я использую это много. Я предполагаю, что существуют еще более необычные решения там и подобные вещи для Mac/Linux/OS/360 или что бы то ни было, но для этого очень технического пользователя, который часто чувствует себя очень нетехническим, потому что он хочет свой ланч, TortoiseSVN (http://tortoisesvn.tigris.org/) поставляет.

Wiki походит на хорошую идею здесь, но если это не подходящий вариант, Вы хотели бы рассматривать использование Сфинкса (или подобный) с текстом ReStructured.

Хотя это также было бы "небольшим проектом программирования", он предоставит Вам HTML, как произведено при сохранении diffs симпатичным и читаемым. Настраивание его, я верю, было бы меньшим количеством усилия, чем для ЛАТЕКСА; кривая обучения была бы довольно много меньшей; и если Вы должны ПРОПИТАТЬ ЛАТЕКСОМ и PDFs в будущем, он там ожидает Вас.

Проблемой с ООО является формат файла, действительно сжатая группа zip файлов (попытайтесь изменить расширение файла на .zip или.7z). Это мешает делать diffs на.

Я смотрел на Латекс и DocBook, но устанавливал шаблон стиля для использования, является довольно трудным. Это - твердая часть, которую заминают все учебные руководства.

Так в основном я разочаровался в получении значимого diffs из документации. В этом регистрируются как двоичные блобы.

Мы имеем, используют Wiki для документации относительно некоторых наших проектов. Это имеет большое отслеживание версии на запись, но не на уровне документа, таким образом, мы экспортировали документы и регистрировали это также для базовых линий.