Document bulk test of questions in a quiz. (#5121)

Author: sangwinc

doc/en/Developer/Development_track.md

@@ -21,6 +21,7 @@ Changes and new features.
 4. Editing of question XML within STACK from link in STACK dashboard. STACK now requires the importasversion plugin to make this possible.
 5. Much code tidying to comply with updated to Moodle Code Checker.
 6. Add in suppport for `style` in Parsons blocks.  E.g. you can now use `style="compact"` to get smaller, tighter items.
+7. Facilitate bulk test for questions in a particular quiz.  (Issue #1521)  Follow the link from the question dashboard to see quizzes in which that question is used.
 
 Issues with [github milestone 4.12.0](https://github.com/maths/moodle-qtype_stack/issues?q=is%3Aissue+milestone%3A4.12.0) include
 

doc/en/STACK_question_admin/Bulk_testing.md

@@ -1,13 +1,12 @@
 # Bulk testing STACK questions on your site
 
-You can bulk test all question tests on all variants of all STACK questions by using the bulk-test script.  Access this functionality from STACK's "adminui" page (or the plugin setting page)
+You can bulk test all question tests on all variants of all STACK questions by using the bulk-test script.  There are two ways to bulk test.
 
-    [...]/question/type/stack/adminui/index.php
+1. Bulk test all questions in a course or category.  To do this, access STACK's "adminui" page (or the plugin setting page) `[...]/question/type/stack/adminui/index.php`
+2. Bulk test all questions in a particular quiz.  Follow the link from the question dashboard to see quizzes in which that question is used.
 
 To make use of the bulk test users require the capability `qtype/stack:usediagnostictools` via Moodle's capability system.
 
-The bulk-test index page lists all Moodle contexts which contain STACK questions.  You can bulk-test by context.
-
 Bulk testing does the following.
 
 1. Validate the STACK question against it's `stackversion` number.  STACK questions store the version of the STACK plug-in _last used_ to edit the question.  The bulk tester checks for changes with the current STACK plug-in version.

stack/cas/castext2/blocks/parsons.block.php

@@ -568,8 +568,10 @@ public function validate(
             ) {
                 $valid    = false;
                 $err[] = stack_string('stackBlock_parsons_unknown_style', ['style' => $stylename]);
-            } else if (!file_exists($CFG->dirroot . '/question/type/stack/corsscripts/parsonsstyles/' .
-                    $stylename . '.min.css')) {
+            } else if (
+                    !file_exists($CFG->dirroot . '/question/type/stack/corsscripts/parsonsstyles/' .
+                    $stylename . '.min.css')
+                ) {
                 $valid    = false;
                 $err[] = stack_string('stackBlock_parsons_unknown_style', ['style' => $stylename]);
             }

tests/parsons_block_test.php

@@ -348,7 +348,7 @@ public function test_parsons_validate_stylename(): void {
             '"3":"\\[ n^2 = (2m+1)^2 = 2(2m^2+2m)+1.\\]", ' .
             '"4":"Define \\(M=2m^2+2m\\in\\mathbb{Z}\\) then \\(n^2=2M+1\\).", ' .
             '} [[/parsons]]';
-        
+
         $at1 = castext2_evaluatable::make_from_source($raw, 'test-case');
         $session = new stack_cas_session2([$at1]);
         $this->assertFalse($at1->get_valid());