Testing instructions guide

Note: This page is a work-in-progress. Feedback and suggested improvements are welcome. Please join the discussion on moodle.org or use the page comments.

This page has suggestions for developers on how to write good testing instructions for the weekly testing of integrated issues.

We recommend that you:

1. Number the steps in your test, and make use of sub-lists.
2. Promote test validations - Confirm, Verify or Ensure - should be in bold so that they are easily identifiable.
3. Only put one test validation on each line - A test step should only have one test validation at a time.
4. Make use of the Jira Markdown formatting.

In addition, the following items may be included:

1. Setup requirements. If so, provide a link to the documentation e.g. https://docs.moodle.org/en/OAuth_2_services if necessary writing something in the dev docs.
2. Whether testing may be done using the Moodle QA testing site.
3. Whether multiple themes (current themes being Boost and Clean for old versions and Boost and Classic for 3.7 and up) should be used.
4. Whether more than one browser should be used. (Tester should specify which browsers they used.)
5. Whether extra testing around the issue is required.