docs: restructure diataxis and aggregation

Signed-off-by: Eike Waldt <waldt@b1-systems.de>
On-behalf-of: SAP <eike.waldt@sap.com>

Author: yeoldegrove

docs/how-to/cli.md

@@ -1,6 +1,10 @@
 ---
-title: "Python Gardenlinux Lib - Release Process"
-github_target_path: "docs/reference/supporting_tools/python-gardenlinux-lib/how-to/release.md"
+title: Release Process - Python Library
+description: Release a new version of the Garden Linux Python Library
+related_topics:
+  - /reference/supporting_tools/python-gardenlinux-lib.md
+  - /reference/python-gardenlinux-lib-cli.md
+  - /how-to/python-gardenlinux-lib-release.md
 migration_status: "new"
 migration_source: ""
 migration_issue: ""
@@ -9,6 +13,7 @@ migration_approved: false
 github_org: gardenlinux
 github_repo: python-gardenlinux-lib
 github_source_path: docs/how-to/release.md
+github_target_path: docs/how-to/python-gardenlinux-lib-release.md
 ---
 
 # Release Documentation
@@ -29,12 +34,10 @@ command line.
 1. **Set version files:**
 
    _python-gardenlinux-lib_ versioning needs to be set in:
-
    - `pyproject.toml`
    - `.github/actions/setup/action.yml`
 
    Additionally at the moment (removal pending):
-
    - `.github/actions/features_parse/action.yml`
    - `.github/actions/flavors_parse/action.yml`
 
@@ -59,6 +62,11 @@ command line.
    ```
 
    Or in `requirements.txt`:
+
    ```
    gardenlinux @ git+https://github.com/gardenlinux/python-gardenlinux-lib.git@1.0.0
    ```
+
+## Related Topics
+
+<RelatedTopics />

docs/how-to/release.md

@@ -1,6 +1,10 @@
 ---
 title: "Python Library"
 description: An overview of the Garden Linux Python Library
+related_topics:
+  - /reference/supporting_tools/python-gardenlinux-lib.md
+  - /reference/python-gardenlinux-lib-cli.md
+  - /how-to/python-gardenlinux-lib-release.md
 migration_status: "new"
 migration_source: ""
 migration_issue: ""
@@ -9,7 +13,7 @@ migration_approved: false
 github_org: gardenlinux
 github_repo: python-gardenlinux-lib
 github_source_path: docs/overview/index.md
-github_target_path: "docs/reference/supporting_tools/python-gardenlinux-lib/overview/index.md"
+github_target_path: "docs/reference/supporting_tools/python-gardenlinux-lib.md"
 ---
 
 # Garden Linux Python Library Documentation
@@ -18,8 +22,6 @@ Welcome to the Garden Linux Python Library documentation. This library provides
 Python tools and utilities for working with Garden Linux features, flavors, OCI
 artifacts, S3 buckets, and GitHub releases.
 
-![Garden Linux Logo](../_static/gardenlinux-logo.svg)
-
 ## Overview
 
 The Garden Linux Python Library is a comprehensive toolkit for managing and
@@ -37,21 +39,20 @@ interacting with Garden Linux components. It includes:
 ### Command-Line Interface
 
 The library provides several command-line tools for common operations. See the
-[Command-Line Interface documentation](../how-to/cli.md) for detailed
+[Command-Line Interface documentation](/reference/python-gardenlinux-lib-cli.md) for detailed
 information about all available commands.
 
 ### Release Management
 
 For information about versioning and release procedures, see the
-[Release documentation](../how-to/release.md).
+[Release documentation](/how-to/python-gardenlinux-lib-release.md).
 
 ### API Reference
 
 For detailed Python API documentation, including all modules, classes, and
 functions, see the
 [API Reference on ReadTheDocs](https://gardenlinux.github.io/python-gardenlinux-lib/api.html).
 
-## Documentation Sections
+## Related Topics
 
-- [Command-Line Interface](../how-to/cli.md)
-- [Release documentation](../how-to/release.md)
+<RelatedTopics />

docs/overview/index.md

@@ -0,0 +1,72 @@
+---
+title: Command-Line Interface - Python Library
+description: Command-Line Interface of the Garden Linux Python Library
+related_topics:
+  - /reference/supporting_tools/python-gardenlinux-lib.md
+  - /reference/python-gardenlinux-lib-cli.md
+  - /how-to/python-gardenlinux-lib-release.md
+migration_status: "new"
+migration_source: ""
+migration_issue: ""
+migration_stakeholder: "@tmangold, @yeoldegrove, @ByteOtter"
+migration_approved: false
+github_org: gardenlinux
+github_repo: python-gardenlinux-lib
+github_source_path: docs/reference/cli.md
+github_target_path: docs/reference/python-gardenlinux-lib-cli.md
+---
+
+# Documentation
+
+_python-gardenlinux-lib_ strictly follows the syntax and intention of
+[Semantic Versioning](https://www.semver.org). Each release reflects the
+intention and expected impact therefore.
+
+A new release is done by tagging a commit with a valid version. This will create
+a GitHub pre-release for proof-reading. Once done a new release can be published
+using GitHub CLI or UI.
+
+Newly added docstrings should contain the first version supporting the new API /
+command line.
+
+## Step by Step Guide
+
+1. **Set version files:**
+
+   _python-gardenlinux-lib_ versioning needs to be set in:
+   - `pyproject.toml`
+   - `.github/actions/setup/action.yml`
+
+   Additionally at the moment (removal pending):
+   - `.github/actions/features_parse/action.yml`
+   - `.github/actions/flavors_parse/action.yml`
+
+2. **Create git tag:**
+
+   ```bash
+   git tag <tag>
+   ```
+
+3. **Review and publish:**
+
+   Review the generated pre-release changelog by visiting the GitHub project
+   release page and publish it if applicable.
+
+4. **Consume the library:**
+
+   Projects consuming the _python-gardenlinux-lib_ may use the following git URL
+   for dependency definition:
+
+   ```bash
+   pip install git+https://github.com/gardenlinux/python-gardenlinux-lib.git@1.0.0
+   ```
+
+   Or in `requirements.txt`:
+
+   ```
+   gardenlinux @ git+https://github.com/gardenlinux/python-gardenlinux-lib.git@1.0.0
+   ```
+
+## Related Topics
+
+<RelatedTopics />