Файлы, зависящие от версии

Question

Представьте приложение с несколькими выпущенными версиями: V1.0, V1.1 и V1.2.

Теперь представьте один или несколько связанных файлов, которые зависят от версии, например руководство пользователя, функциональный набор тестов или техническая документация. В идеале эти файлы будут проверяться в версии вместе с самим приложением, так что легко просмотреть и/или просмотреть все файлы, относящиеся к определенной версии (например, запустить функциональные тесты как часть непрерывной сборки).

Проблема в том, что любой из этих файлов может потребоваться обновить, даже если код отсутствует. Например, мы могли бы обнаружить ошибки в руководстве пользователя V1.0, которое мы хотим исправить в интересах клиентов, которые все еще используют эту версию. Или мы можем улучшить освещение функциональных тестов для V1.2, чтобы обнаружить ошибки в этой версии до того, как наши клиенты сделают это. Соответственно, изменив эти файлы, как мы их передаем в управление версиями? Мы не выпускаем новые версии программного обеспечения, а только новые версии файлов, которые идут с ними.

FWIW, мы используем SVN.

Answer 1

Я действительно не вижу проблемы.

Вы совершаете так часто, как вам нравится; то, о чем вы говорите, может привести к различным пересмотрам данных документов и сконденсировать их в один «выпуск». Вполне возможно сделать это, в зависимости от того, как вы строите. Вы можете просто обновить определенные вещи до определенных версий (по крайней мере, в SVN, вы можете, я не могу говорить для других систем (скажем, безопасный визуальный источник (бог вам помочь)]).

Если вы используете SVN, вас также может заинтересовать функция 'tagging'.

Answer 2

Если все, что связано с проектом (документация, функциональные тесты), копируется (разветвляется) при выпуске новой версии, то все, что вам нужно сделать, это обновить то, что вам нужно на ветке.

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