docs: Reorg and improve user experience

.github/workflows/static-analysis.yml

@@ -92,12 +92,8 @@ jobs:
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
         with:
           fetch-depth: 0
-      - name: Setup Node
-        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6
       - name: Check for Markdown issues
-        run: |
-          npm install -g markdownlint-rule-max-one-sentence-per-line@0.0.2
-          npx markdownlint-cli2
+        uses: DavidAnson/markdownlint-cli2-action@07035fd053f7be764496c0f8d8f9f41f98305101 # v22
   prettier-website:
     runs-on: ubuntu-24.04
     steps:

.markdownlint-cli2.yaml

@@ -1,8 +1,6 @@
 #  Configuration for the markdownlint-cli2, see:
 #  https://github.com/DavidAnson/markdownlint-cli2/blob/main/test/markdownlint-cli2-yaml-example/.markdownlint-cli2.yaml
 
-customRules:
-  - markdownlint-rule-max-one-sentence-per-line
 globs:
   - "**/*.md"
 ignores:

buildSrc/src/main/kotlin/GeneratePluginDocsTask.kt

@@ -37,7 +37,7 @@ abstract class GeneratePluginDocsTask : DefaultTask() {
     abstract var inputFiles: FileTree
 
     @OutputDirectory
-    val outputDirectory = project.layout.projectDirectory.file("website/docs/plugins").asFile
+    val outputDirectory = project.layout.projectDirectory.file("website/docs/reference/plugins").asFile
 
     @Internal
     val jsonSlurper = JsonSlurper()

website/docs/related-tools.md → website/docs/about/related-tools.md

@@ -1,11 +1,18 @@
----
-sidebar_position: 8
-sidebar_label: Related Tools
----
-
 # Related Tools
 
-## ORT Config Repository
+## Forgejo action for ORT
+
+A [Forgejo Action](https://github.com/oss-review-toolkit/ort-ci-github-action) to run ORT.
+
+## GitHub action for ORT
+
+A [GitHub Action](https://github.com/oss-review-toolkit/ort-ci-github-action) to run ORT.
+
+## GitLab job template for ORT
+
+A [GitLab job template](https://github.com/oss-review-toolkit/ort-ci-gitlab) to run ORT.
+
+## ORT config repository
 
 A [repository](https://github.com/oss-review-toolkit/ort-config) with exemplary ORT configuration files.
 
@@ -17,18 +24,10 @@ It is designed to run inside a Kubernetes cluster and can be used via a REST API
 ## ORT Workbench
 
 The [ORT Workbench](https://github.com/oss-review-toolkit/ort-workbench) is an ORT result file viewer developed by the ORT core team.
-It can be used as an alternative to creating a [report](tools/reporter.md) to review the ORT output.
+It can be used as an alternative to creating a [report](reference/cli/reporter.md) to review the ORT output.
 
 ![Screenshot](https://github.com/oss-review-toolkit/ort-workbench/raw/main/assets/screenshot.png)
 
-## ORT GitHub Action
-
-A [GitHub Action](https://github.com/oss-review-toolkit/ort-ci-github-action) to run ORT for your GitHub repositories.
-
-## ORT GitLab Pipeline
-
-A [GitLab Pipeline](https://github.com/oss-review-toolkit/ort-gitlab-ci) to run ORT for your GitLab repositories.
-
 ## ORTHW
 
 A [bash script](https://github.com/oss-review-toolkit/orthw) that helps to simplify and speed up common tasks performed when processing ORT results.