Commit Guidelines¶
Access to directly submit changes is limited to people with commit access to the repository. Once you are provided with commit access you can start committing directly instead of creating a patch file.
You can make commits from your Git client or using the Git command line tool. The following command will create a commit and send it to the central repository:
git commit -m "This is what I did"
git push
Якщо ви залишите -m "message"
, то отримаєте запит увести це повідомлення у текстовому редакторі.
Порада
You should make sure you are always on the latest revision before committing. You may not be able to commit directly if there are conflicting changes in the latest revision.
To avoid this update your local repository before committing (run make update
).
Дивись також
Дивись також
See release branch for documentation on how to make commits to a specific release branch and how to create merge commits.
Writing a Good Commit Message – Написання Хорошого Повідомлення щодо Фіксації¶
Під час внесення змін до цього підручника, які безпосередньо стосуються конкретної фіксації (зміни) у Blender, корисно зробити назву фіксації такою ж, як і у фіксації, зробленої у Blender. Бажано, щоб ви включили хеш зробленої фіксації у джерельний код Blender’а.
Наприклад, фіксація rBM8473 включає описове вказування змін, зроблених разом з хешем rBa71d2b260170
. Цей хеш може бути витягнуто з URL, наданого в Documentation task для конкретного прийдешнього випуску.
Інші більш загальні зміни не обов’язково повинні відповідати вищезазначеній політиці, однак важливо робити опис зрозумілим щодо того, які зміни ви внесли та чому. Може бути корисно додати до назви фіксації префікс, наприклад Cleanup:
або Fix:
, коли ви робите загальні вичищення або виправлення відповідно.
Написання хороших повідомлень про фіксацію допомагає адміністраторам відстежувати внесені зміни та гарантує, що всі нові функції належним чином задокументовані.