Testing instructions guide: Difference between revisions
From MoodleDocs
(Make the list a little clearer, and add a link to Jira markdown formatting.) |
Dev Docs Bot (talk | contribs) 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: | ||
{{ | {{Template:Migrated|newDocId=/general/development/process/testing/guide}} | ||
| | |||
}} | |||
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. | ||
# 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 | # 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:
- Number the steps in your test, and make use of sub-lists.
- Only put one action (preparation or validation) on each line - A step should only define a unique operation.
- Promote test validations - Confirm, Verify or Ensure - should be in bold so that they are easily identifiable.
- Make use of the Jira Markdown formatting.
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.
- 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 Moodle QA testing site.
- Whether multiple themes (current themes being Boost and Clean for old versions and Boost and Classic for 3.7 and up) should be used.
- Whether more than one browser should be used. (Tester should specify which browsers they used.)
- Whether extra testing around the issue is required.