Note:

If you want to create a new page for developers, you should create it on the Moodle Developer Resource site.

Testing instructions guide: Difference between revisions

From MoodleDocs
(Make the list a little clearer, and add a link to Jira markdown formatting.)
m (Protected "Testing instructions guide": Developer Docs Migration ([Edit=Allow only administrators] (indefinite)))
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Work in progress
{{Template:Migrated|newDocId=/general/development/process/testing/guide}}
|forumurl = https://moodle.org/mod/forum/view.php?id=55
|info =
}}
This page has suggestions for developers on how to write good testing instructions for the weekly [[Testing of integrated issues|testing of integrated issues]].
This page has suggestions for developers on how to write good testing instructions for the weekly [[Testing of integrated issues|testing of integrated issues]].


We recommend that you:
We recommend that you:
# Number the steps in your test, and make use of sub-lists.
# Number the steps in your test, and make use of sub-lists.
# Promote test validations - Confirm, Verify or Ensure - should be in bold so that they are easily identifiable.
# Only put one action (preparation or validation) on each line - A step should only define a unique operation.
# Only put one test validation on each line - A test step should only have one test validation at a time.
# Promote test validations - '''Confirm''', '''Verify''' or '''Ensure''' - should be in '''bold''' so that they are easily identifiable.
# Make use of the [https://tracker.moodle.org/secure/WikiRendererHelpAction.jspa?section=all Jira Markdown formatting].
# Make use of the [https://tracker.moodle.org/secure/WikiRendererHelpAction.jspa?section=all Jira Markdown formatting].
In addition, the following items may be included:
In addition, the following items may be included:
# 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.
# 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.
# Whether testing involves git/shell interaction, SQL operations... (commands in general), don't assume the tester knows how to perform that stuff. Instead, add them explicitly to the instructions.
# Whether testing may be done using the [https://qa.moodle.net/ Moodle QA testing site].
# Whether testing may be done using the [https://qa.moodle.net/ Moodle QA testing site].
# Whether the Boost and / or Clean theme should be used.
# Whether multiple themes {{Template:CurrentlySupportedThemes}} should be used.
# Whether more than one browser should be used. (Tester should specify which browsers they used.)
# Whether more than one browser should be used. (Tester should specify which browsers they used.)
# Whether extra testing around the issue is required.
# Whether extra testing around the issue is required.
[[Category: Processes]]
[[Category: Processes]]

Latest revision as of 07:27, 6 May 2022

Important:

This content of this page has been updated and migrated to the new Moodle Developer Resources. The information contained on the page should no longer be seen up-to-date.

Why not view this page on the new site and help us to migrate more content to the new site!

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. Only put one action (preparation or validation) on each line - A step should only define a unique operation.
  3. Promote test validations - Confirm, Verify or Ensure - should be in bold so that they are easily identifiable.
  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 involves git/shell interaction, SQL operations... (commands in general), don't assume the tester knows how to perform that stuff. Instead, add them explicitly to the instructions.
  3. Whether testing may be done using the Moodle QA testing site.
  4. Whether multiple themes (current themes being Boost and Clean for old versions and Boost and Classic for 3.7 and up) should be used.
  5. Whether more than one browser should be used. (Tester should specify which browsers they used.)
  6. Whether extra testing around the issue is required.