You are viewing the latest unreleased documentation 3.10.0.dev41. You can switch to a stable version.

Pull Request Checklist#

All pull request will be reviewed by a core developer who will manage the process of merging. It is the responsibility of the contributor submitting a pull request to do their best to deliver a pull request which meets the requirements of the project it is submitted to.

This check list summarises criteria which will be checked before a pull request is merged. Before submitting a pull request please consider the following:

  1. Provide a helpful description of the Pull Request. This should include:

    • The aim of the change / the problem addressed / a link to the issue.

    • How the change has been delivered.

  2. Include a “What’s New” entry, if appropriate. See Contributing a “What’s New” Entry.

  3. Check all tests pass. This includes existing tests and any new tests added for any new functionality. For more information see Running the Tests.

  4. Check all modified and new source files conform to the required Code Formatting.

  5. Check all new dependencies added to the requirements yaml files. If dependencies have been added then new nox testing lockfiles should be generated too, see GitHub Actions Test Environment.

  6. Check the source documentation been updated to explain all new or changed features. Note, we now use numpydoc strings. Any touched code should be updated to use the docstrings formatting. See Docstrings.

  7. Include code examples inside the docstrings where appropriate. See Testing.

  8. Check the documentation builds without warnings or errors. See Building

  9. Check for any new dependencies in the readthedocs.yml file. This file is used to build the documentation that is served from

  10. Check for updates needed for supporting projects for test or example data. For example:

    • iris-test-data is a github project containing all the data to support the tests.

    • iris-sample-data is a github project containing all the data to support the gallery and examples.

    If new files are required by tests or code examples, they must be added to the appropriate supporting project via a suitable pull-request. This pull request should be referenced in the main Iris pull request and must be accepted and merged before the Iris one can be.