commits

You should only commit changes that are contextually related, that is your changes should be grouped in a logical way. Before pushing, you can squash your commits (see here for an example).

Commit messages

Your commit messages should be descriptive, as they will appear on the CHANGELOG.rst file. It should look something like this (based on this):

The first 50 characters are used for the commit summary (A blank line, no text here) The next section can take up to 72 characters It probably makes sense to split them into smaller sentences This section contains a more detailed description of your commit Why something was added or removed and what was changed or fixed Which files were involved (if there are too many, your commit is too large) (Another blank line) Bugs fixed: #1234 Implements: name_of_package

You can read more about how to write commit messages here and here.