docs: Reorg and improve user experience

Reorganize and improve documentation to provide a better getting started
and documentation navigation user experience.

This pull requests includes:
- Adoption of the Diátaxis framework which prioritizes user needs and
  organizes documentation accordingly. This approach ensures users can
  easily find the information they need while providing authors with
  clear guidance on improving documentation for a better user experience.
- A new tutorial on how to use ORT
- Several how-to guides have been added explaining how to accomplish
  specific tasks with ORT
- Introduces a new explanation section to provide background and context
  e.g. the 'why' things are so
  (design decisions, historical reasons, technical constraints)

Co-authored-by: Jonatan Männchen <jonatan@maennchen.ch>
Signed-off-by: Jonatan Männchen <jonatan@maennchen.ch>
Signed-off-by: Thomas Steenbergen <opensource@steenbe.nl>

Author: tsteenbe

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.mdwebsite/docs/related-tools.md renamed to 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.