Blogerator.org

× Версия для печати

У меня часто накапливаются очередные pack’и из полезных тематических ссылок, которые могут в любой момент пригодиться, только не знаешь когда. В итоге получается что-то типа шпоры на все времена. В прошлый раз я писал про каталоги для фанатов качественного тематического чтения из завалов awesome-списков, а теперь выкладываю список полезных ссылок по трем жизненно важным пунктам, в которых стоит раз и навсегда навести порядок.

Итак, сегодня только три темы, но в них нужен максимум сознательности:

• Как правильно нумеровать версии своего софта
• Как нужно правильно вести и оформлять changelog программы
• Как правильно оформлять описание коммитов

Сознательное следование всем этим выстраданным методологиям существенно сократит ваш технический долг (aka карму) перед Вселенной. Обилие дистиллированных ссылок — под катом.

1. Релизы и их версии

Как правильно нумеровать версии софта, что такое минорные и мажорные версии релизов? Версионность проектов и нумерация билдов программы.

• Семантическое версионирование
• Нумерация версий ПО для новичков и не только
• Нумерация версий программного обеспечения
• Нумерация версий ПО

2. Changelog для умных

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

• Большое руководство по ведению чэнджлога
• Правила ChangeLogs в проекте GNU

3. Логика описания коммита

Как правильно нужно гитить коммиты и документировать свои патчи (стиль и правила именования коммитов). Система логирования истории изменений и коммитов в репозитории проекта.

• Стиль именования коммитов
• A Note About Git Commit Messages
• How to Write a Git Commit Message
• Writing good commit messages
• 5 Useful Tips For A Better Commit Message

Git для людей: https://t.co/ywbAeif45Y. О том, как оформлять коммиты, чтобы потом не было больно. pic.twitter.com/JLckvir8ki
— Хабрахабр (@habrahabr) February 8, 2016