diff --git a/TESTING.md b/TESTING.md index 9772925..67506c0 100644 --- a/TESTING.md +++ b/TESTING.md @@ -15,6 +15,12 @@ the testbot's behavior. You can find information on how to run `run-tests.sh` locally here: https://www.drupal.org/node/645286 +Examples is always targeted to the dev branch of Drupal core for the latest release. +As of this writing, the latest release of Drupal core is 8.2.5, which means +development for Examples should be against the Drupal 8.2.x development branch. +When Drupal 8.3.0 is released, we'll start targeting Examples to 8.3.x, and so +on. + You should at least run `run-tests.sh` locally against all the changes in your patch before uploading it. @@ -27,6 +33,25 @@ suggested workaround for this, since there is no best practice to demonstrate as an example. There is, however, this issue in core: https://www.drupal.org/node/2499239 +How To Run The Tests In The Drupal UI +------------------------------------- + +Generally, you should run tests from the command line. This is generally easier +than using Drupal's testing UI. However, here's how you can do it that way: + +Enable the Testing module. + +Visit the test list page at `admin/config/development/testing`. + +Since the tests are organized by module, you can search for a module name and +get all the tests for that module. For instance, type in 'node_type_example' for +all the tests related to that module. + +Click the check boxes next to the tests you want to run. If you find this +tedious, it's time to learn to use the command line. :-) + +Click 'Run Tests.' You're now running the tests. + Step-by-step: How To Run The Tests. ----------------------------------- @@ -34,6 +59,9 @@ Begin with an installed Drupal codebase. Make a codebase, set up the database, etc. Note that you can use an existing Drupal instance but the best practice is to start fresh. Something not working right? Try a new installation. +Use the dev branch of core for the latest release of Drupal. As of this writing, +it's 8.2.x. When Drupal 8.3.0 is released, we'll target 8.3.x. + Open the terminal window and move to the root directory of the Drupal installation: