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",你將被提示需在文字編輯器中輸入留言。

Tip

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 also

See Release Cycle for documentation on how to make commits to a specific release branch and how to create merge commits.

Writing a Good Commit Message#

When making changes to the manual that directly relate to a specific commit (change) in Blender, it is helpful to make the title of the commit the same as the commit made to Blender. It is requested that you include the commit hash of the commit made to the Blender source code.

For example, the commit rBM8473 includes a descriptive indicative of the changes made along with the hash rBa71d2b260170. The hash can be extracted from the URL provided in the Documentation task for a specific upcoming release.


Other more general changes do not have to follow the above policy however, it is still important to make the description clear about what changes you made and why. It can be helpful to prefix the commit title with a prefix word such as Cleanup: or Fix: when you are making general cleanups or fixes respectively.

Writing good commit messages helps administrators keep track of changes made and ensures all new features are properly documented.