Patch & Commit

Submit Patches

The first few times you make changes to the manual, you will need to submit them as patches for an administrator to review. This is just to make sure that we maintain a quality user manual, and that you do not accidentally break anything vital before you get used to the system.

In order to submit a patch, follow this process:

  1. Make any changes that you want.

  2. Create a patch file by running:

    svn diff > filename.diff
    

    This creates a simple text file that shows what text was added, removed or changed between your working files and the central repository.

    If you have created or deleted files, you will need to run svn add /path/to/file or svn rm /path/to/file before creating the diff. To see a list of affected files, run svn status.

  3. Upload the diff file here.

  4. After submitting the diff, you will be asked to “Create a new Revision” before you can add a title and description of your changes.

  5. Please check if the Documentation project is assigned in the tag’s field in order to notify the team of your patch. You can also contact the team over the mailing list or Blender Chat.

  6. They will review your patch and let you know about any changes you could make. If there is no issue, your patch will be accepted and then committed by the team of your patch.

Note

If your patch includes changes to or additional images, simply attach them when you are creating the revision.

Straightforward patches are bound to be accepted very quickly. Once you get accustomed to making changes and no longer need feedback, we cut out the middle man and give you direct access to edit the manual.

See also

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

Commit Directly

Access to directly submit changes is limited to people with commit access to the SVN 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 SVN client or using the SVN command line tool. The following command will create a commit and send it to the central repository:

svn commit -m "This is what I did"

If you leave out -m "message", you will be prompted to type the message in a text editor.

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 run svn update before committing.

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.