Правильный порядок тегов и версий ошибок

Question

У меня есть библиотека на github, которая использует rebar, но она никогда не была помечена через git. На момент написания статьи файл app.src указывает, что это версия 0.1 (это никогда не менялось).

Я хотел бы сделать несколько коммитов, которые изменят некоторые определения функций. Мне нужно использовать теги и версии приложений, чтобы это не оказывало негативного влияния на пользователей, но мне непонятно, в каком порядке я должен метить, ударять и т. Д.

Какие шаги я предприму сейчас и в будущем, чтобы гарантировать, что пользователи смогут писать код для выбранной версии?

Answer 1

Я использую следующую схему в своих репозиториях:

• XYZ, где X является основным, Y - второстепенным, а Z - выпуском патчей (на основе некоторых идей из версии Semantinc Versioning)

• Порядок изменения файлов и тегов.app.src следующий:

  1. Внесите изменения, увеличьте номер версии в файле.app.src и зафиксируйте его с хорошим сообщением фиксации.

  2. Пометьте тег, используя тот же номер версии, что и в файле.app.src. Я ввожу теговое сообщение следующей формы:

     Version X.Y.Z
     
     - New Feature 1
     - New Feature 1
     - Fix this and that
     

     Затем тег подписывается GPG моей подписью (используя -s флаг)

  3. Нажмите коммит с git push && git push --tags загрузить на сервер как коммит, так и тег.

Я не использую семантическую версию "vX.YZ" в качестве тегов, потому что я думаю, что это излишне и выглядит не очень хорошо.

Если у вас есть правильные теги и версионирование (по вашему выбору), ваши пользователи смогут полагаться на использование тегов Git как есть.

Вы можете увидеть результаты здесь: https://github.com/eproxus/meck (вам нужно скачать код, чтобы увидеть сообщения тегов и проверить подпись GPG).