456: catalog update nox task descriptions

.github/workflows/slow-checks.yml

@@ -19,8 +19,6 @@ jobs:
     runs-on: "ubuntu-24.04"
     permissions:
       contents: read
-    env:
-      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
     strategy:
       fail-fast: false
       matrix: ${{ fromJson(needs.build-matrix.outputs.matrix) }}
@@ -33,7 +31,7 @@ jobs:
 
       - name: Set up Python & Poetry Environment
         id: set-up-python-and-poetry-environment
-        uses: exasol/python-toolbox/.github/actions/python-environment@v8
+        uses: exasol/python-toolbox/.github/actions/python-environment@v10
         with:
           python-version: ${{ matrix.python_versions }}
           poetry-version: "2.3.0"

doc/changes/unreleased.md

@@ -1,3 +1,10 @@
 # Unreleased
 
 ## Summary
+
+This release documents how to discover and use PTB's Nox sessions in the user
+guide and removes the unused Modules section from the developer guide.
+
+## Documentation
+
+* #456: Documented how to discover PTB nox sessions in the user guide and removed the unused developer-guide Modules section

doc/developer_guide/developer_guide.rst

@@ -9,4 +9,3 @@
 
     ../design
     plugins
-    modules/modules

doc/user_guide/features/index.rst

@@ -37,3 +37,17 @@ Important Nox Commands
 
 * :code:`nox -l` shows a list of all available nox sessions
 * :code:`nox -s <session>` run the specified session(s)
+
+The command :code:`nox -l` is the most reliable way to see the full current
+session list for your project.
+
+Common examples are:
+
+* :code:`nox -s format:fix` to apply formatting changes
+* :code:`nox -s project:check` to run the main local quality gate
+* :code:`nox -s test:unit` to run unit tests
+* :code:`nox -s workflow:generate -- all` to regenerate PTB workflows
+
+Use the feature pages in this guide for task-specific details, for example
+formatting, GitHub workflows, dependency management, release preparation, and
+code-quality reporting.

test/integration/tools/security_integration_test.py

@@ -88,9 +88,13 @@ def test_without_existing_github_issue_passes_through(
         json_path = tmp_path / "input.json"
         json_path.write_text(sample_maven_vulnerabilities.issues_json)
 
-        result = cli_runner.invoke(
-            CVE_CLI, ["filter", Filter.GitHubIssues.value, str(json_path)]
-        )
+        with patch(
+            "exasol.toolbox.tools.security.gh_security_issues",
+            return_value=(),
+        ):
+            result = cli_runner.invoke(
+                CVE_CLI, ["filter", Filter.GitHubIssues.value, str(json_path)]
+            )
 
         assert result.exit_code == 0
         assert result.output.strip() == sample_maven_vulnerabilities.issues_json