minor #3417 Enhancement: Introduce DOCtor-RST config + GithubAction (OskarStark)

This PR was squashed before being merged into the 3.x branch.

Discussion
----------

Enhancement: Introduce DOCtor-RST config + GithubAction

Commits
-------

8ac8cb71 Enhancement: Introduce DOCtor-RST config + GithubAction

.github/workflows/documentation.yml

@@ -4,7 +4,7 @@ on:
     pull_request:
     push:
         branches:
-            - '1.x'
+            - '3.x'
 
 jobs:
     build:

doc/.doctor-rst.yaml

@@ -38,16 +38,16 @@ rules:
     yarn_dev_option_at_the_end: ~
 
     versionadded_directive_major_version:
-        major_version: 2
+        major_version: 3
 
     versionadded_directive_min_version:
-        min_version: '2.0'
+        min_version: '3.0'
 
     deprecated_directive_major_version:
-        major_version: 2
+        major_version: 3
 
     deprecated_directive_min_version:
-        min_version: '2.0'
+        min_version: '3.0'
 
 whitelist:
     lines:

doc/advanced.rst

@@ -879,7 +879,9 @@ structure in your test directory::
 
 The ``IntegrationTest.php`` file should look like this::
 
-    class Project_Tests_IntegrationTest extends \Twig\Test\IntegrationTestCase
+    use Twig\Test\IntegrationTestCase;
+
+    class Project_Tests_IntegrationTest extends IntegrationTestCase
     {
         public function getExtensions()
         {

doc/filters/batch.rst

@@ -10,13 +10,13 @@ missing items:
     {% set items = ['a', 'b', 'c', 'd'] %}
 
     <table>
-    {% for row in items|batch(3, 'No item') %}
-        <tr>
-            {% for column in row %}
-                <td>{{ column }}</td>
-            {% endfor %}
-        </tr>
-    {% endfor %}
+        {% for row in items|batch(3, 'No item') %}
+            <tr>
+                {% for column in row %}
+                    <td>{{ column }}</td>
+                {% endfor %}
+            </tr>
+        {% endfor %}
     </table>
 
 The above example will be rendered as:

doc/filters/format.rst

@@ -11,8 +11,8 @@ The ``format`` filter formats a given string by replacing the placeholders
     {# outputs I like foo and bar
        if the foo parameter equals to the foo string. #}
 
-.. _`sprintf`: https://secure.php.net/sprintf
-
 .. seealso::
 
     :doc:`replace<replace>`
+
+.. _`sprintf`: https://secure.php.net/sprintf