Merge pull request #14817 from nextcloud/copilot/backport-14769-and-14771-to-stable32

[stable32] Backport sphinx-lint CI (#14769) and enable all checks (#14771) to stable32

Author: skjnldsv

.github/problem-matchers/sphinx-lint.json

@@ -0,0 +1,15 @@
+{
+  "problemMatcher": [
+    {
+      "owner": "sphinx-lint",
+      "pattern": [
+        {
+          "regexp": "^([^:]+\\.(?:rst|py)):(\\d+): (.+)$",
+          "file": 1,
+          "line": 2,
+          "message": 3
+        }
+      ]
+    }
+  ]
+}

.github/workflows/sphinx-lint.yml

@@ -0,0 +1,42 @@
+name: 'Sphinx Lint'
+
+on:
+  pull_request:
+  push:
+    branches:
+      - master
+      - stable*
+
+permissions:
+  contents: read
+
+jobs:
+  sphinx-lint:
+    name: Lint RST files
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: "3.13"
+          cache: "pip"
+
+        # The workflow pins sphinx-lint directly (not via requirements.txt) to keep
+        # this job lightweight — requirements.txt pulls in the full Sphinx build
+        # stack (Pillow, rst2pdf, reportlab, …) which is not needed for linting.
+        # sphinx-lint is also listed in requirements.txt so local dev environments
+        # get the same version when running `pip install -r requirements.txt`.
+      - name: Install sphinx-lint
+        run: pip install sphinx-lint==1.0.2
+
+      - name: Register sphinx-lint problem matcher
+        run: echo "::add-matcher::.github/problem-matchers/sphinx-lint.json"
+
+      - name: Run sphinx-lint
+        run: sphinx-lint admin_manual developer_manual user_manual

admin_manual/ai/app_context_agent.rst

@@ -442,8 +442,8 @@ Known Limitations
 -----------------
 * Make sure to test the language model you are using in concert with this app for whether they meet the use-case's quality requirements
 * Most models have difficulties with languages other than English. Some models sometimes answer in a different language than the one used by the user.
-* Customer support is available upon request, however we can't solve false or problematic output, most performance issues, or other problems caused by the underlying model. 
-  Support is thus limited only to bugs directly caused by the implementation of the app (connectors, API, front-end, AppAPI). We still try to optimize this as far as possible, so if you encounter any false or problematic output, you can report it `in a dedicated Github issue <https://github.com/nextcloud/context_agent/issues/51>`_ to help us improve this app. 
+* Customer support is available upon request, however we can't solve false or problematic output, most performance issues, or other problems caused by the underlying model.
+  Support is thus limited only to bugs directly caused by the implementation of the app (connectors, API, front-end, AppAPI). We still try to optimize this as far as possible, so if you encounter any false or problematic output, you can report it `in a dedicated Github issue <https://github.com/nextcloud/context_agent/issues/51>`_ to help us improve this app.
 * When multiple MCP services are configured that have tools with the same name undefined behavior will occur.
 * Only remote MCP services are supported (streamable_http transport).
-* MCP services that require different access tokens for each user are not currently supported.
+* MCP services that require different access tokens for each user are not currently supported.

admin_manual/ai/app_summary_bot.rst

@@ -88,7 +88,7 @@ After cloning this app *manually* (cloned via git to your apps directory) you wi
 .. code-block::
 
    sudo -E -u www-data php occ app_api:app:unregister summary_bot
-   
+
 
 5. Register the Summary Bot so that your Nextcloud instance is aware of it
 
@@ -125,7 +125,7 @@ Ethical AI Rating
 
 The ethical rating of the *Summary Bot*, which utilizes a model for text processing through the Nextcloud Assistant app, is significantly influenced by the choice and implementation of the underlying model.
 
-Learn more about the Nextcloud Ethical AI Rating `in our blog<https://nextcloud.com/blog/nextcloud-ethical-ai-rating/>`.
+Learn more about the Nextcloud Ethical AI Rating `in our blog <https://nextcloud.com/blog/nextcloud-ethical-ai-rating/>`_.
 
 Known Limitations
 -----------------

admin_manual/ai/insight_and_debugging.rst

@@ -91,4 +91,4 @@ For example
      {
         ...
      }
-   ]
+   ]

admin_manual/apps_management.rst

@@ -100,7 +100,7 @@ For example, to enable the "files" app, run:
 To enable the app for specific groups, use the `--groups` option:
 
 ::
-  
+
   occ app:enable files --groups=admin
 
 

admin_manual/conf.py

@@ -6,7 +6,7 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
 #
 ## Note that additional configuration elements shared by all Nextcloud docs
-## are loaded from `../conf.py`. 
+## are loaded from `../conf.py`.
 
 # -- Path setup --------------------------------------------------------------
 
@@ -119,7 +119,7 @@
         'Nextcloud',
         'The Nextcloud Server Administration Manual.',
         'Miscellaneous',
-    ), 
+    ),
 ]
 
 # -- Options for todo extension ----------------------------------------------

admin_manual/configuration_database/bigint_identifiers.rst

@@ -3,8 +3,8 @@ BigInt (64bit) identifiers
 ==========================
 
 Nextcloud uses big integers to store identifiers and auto-increment keys in the database.
-Because changing columns on huge tables can take quite a while (up to hours or days) 
-depending on the number of files in the Nextcloud instance, this migration on the filecache 
+Because changing columns on huge tables can take quite a while (up to hours or days)
+depending on the number of files in the Nextcloud instance, this migration on the filecache
 and activity table has to be triggered manually by a console command.
 
 The command can safely be executed. It will show a success message when there is nothing to do::

admin_manual/configuration_database/db_conversion.rst

@@ -19,7 +19,7 @@ Conversion consists of two steps:
 Establishing the target database
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-First create up the target (new) database (along with its associated username and password) by following the manual database configuration instructions for your chosen target database type: 
+First create up the target (new) database (along with its associated username and password) by following the manual database configuration instructions for your chosen target database type:
 
 * :ref:`db-config-mysql-label`
 * :ref:`db-config-postgresql-label`
@@ -36,7 +36,7 @@ The ``occ db:convert-type`` command handles all the tasks of the conversion. The
 
   sudo -E -u www-data php occ db:convert-type [options] type username hostname database
 
-``type`` should be the target database type. The same values are available here as for the ``config.php`` ``dbtype`` parameter. It should be one of: ``mysql`` for MariaDB/MySQL, 
+``type`` should be the target database type. The same values are available here as for the ``config.php`` ``dbtype`` parameter. It should be one of: ``mysql`` for MariaDB/MySQL,
 ``pgsql`` for PostgreSQL, or ``oci`` for Oracle.
 
 The options:
@@ -57,8 +57,8 @@ Let's convert our existing (functioning) sqlite3 installation to be MariaDB/MySQ
 
   sudo -E -u www-data php occ db:convert-type --password="<password>" --port="3306" --all-apps mysql <username> <hostname> nextcloud
 
-.. note:: It was unnecessary to specify the port in this example because ``3306`` is already the default. We did so 
-   merely for demonstration purposes and completeness in case the reader is using a non-standard port on their target 
+.. note:: It was unnecessary to specify the port in this example because ``3306`` is already the default. We did so
+   merely for demonstration purposes and completeness in case the reader is using a non-standard port on their target
    database server.
 
 On success the converter will automatically configure the new database in your
@@ -70,7 +70,7 @@ If you are converting to a MySQL/MariaDB database, you will also want to set ``m
 
    sudo -E -u www-data php occ config:system:set mysql.utf8mb4 --type boolean --value="true"
 
-If you like, you can view the changes that were made by looking for the ``db*`` parameters in your ``config.php`` (you could also use this command before 
+If you like, you can view the changes that were made by looking for the ``db*`` parameters in your ``config.php`` (you could also use this command before
 doing the conversion to compare your configuration before/after):
 
 ::

admin_manual/configuration_database/linux_database_configuration.rst

@@ -193,7 +193,7 @@ Adjust the paths to the pem files for your environment.
 PostgreSQL database
 ^^^^^^^^^^^^^^^^^^^
 
-In order to run Nextcloud securely on PostgreSQL, it is assumed that only 
+In order to run Nextcloud securely on PostgreSQL, it is assumed that only
 Nextcloud uses this database and thus only one user accesses the database.
 For further services and users, we recommend to create a separate
 database or PostgreSQL instance.