From 15c6b723031ef8b885b8a7d73449b3ac20019ae7 Mon Sep 17 00:00:00 2001 From: Eike Waldt Date: Thu, 2 Apr 2026 16:32:54 +0200 Subject: [PATCH 1/2] fix: tutorial start Signed-off-by: Eike Waldt On-behalf-of: SAP --- docs/tutorials/index.md | 20 -------------------- 1 file changed, 20 deletions(-) diff --git a/docs/tutorials/index.md b/docs/tutorials/index.md index 3c1f80b..13944fa 100644 --- a/docs/tutorials/index.md +++ b/docs/tutorials/index.md @@ -23,26 +23,6 @@ Want to try Garden Linux right now with zero setup cost? All three tutorials run entirely on your workstation in under 5 minutes. ::: -:::danger Recommended First Tutorial -Want to try Garden Linux right now with zero setup cost? - -- **Linux**: [First Boot on KVM](./local/first-boot-kvm.md) or [First Boot on Lima](./local/first-boot-lima.md) -- **macOS**: [First Boot on Lima](./local/first-boot-lima.md) -- **Any OS with Container Engine**: [First Boot as OCI Container](./container/first-boot-oci.md) - -All three tutorials run entirely on your workstation in under 5 minutes. -::: - -:::warning Recommended First Tutorial -Want to try Garden Linux right now with zero setup cost? - -- **Linux**: [First Boot on KVM](./local/first-boot-kvm.md) or [First Boot on Lima](./local/first-boot-lima.md) -- **macOS**: [First Boot on Lima](./local/first-boot-lima.md) -- **Any OS with Container Engine**: [First Boot as OCI Container](./container/first-boot-oci.md) - -All three tutorials run entirely on your workstation in under 5 minutes. -::: - ## About Tutorials From 7376e62c19ed2a0fff2cfc15727e76c100293fe9 Mon Sep 17 00:00:00 2001 From: Eike Waldt Date: Thu, 9 Apr 2026 14:40:27 +0200 Subject: [PATCH 2/2] feat: rework mission statement Signed-off-by: Eike Waldt On-behalf-of: SAP --- docs/index.md | 28 ++++++++++++++++++---------- docs/overview/index.md | 16 +++++++++++++++- repos-config.json | 32 ++++++++++++++++++++++++++------ 3 files changed, 59 insertions(+), 17 deletions(-) diff --git a/docs/index.md b/docs/index.md index 86c4d7b..dd9b2e1 100644 --- a/docs/index.md +++ b/docs/index.md @@ -4,15 +4,15 @@ layout: home hero: name: "Garden Linux" - text: "the best Linux for Gardener nodes" - tagline: "small, auditable Linux images for cloud and bare-metal workloads" + text: "Purpose-built Linux for cloud-native workloads" + tagline: "Debian-based, fully open source, and optimized for Kubernetes and containers" actions: - theme: brand - text: First Boot Tutorial - link: /tutorials/ - - theme: alt - text: Browse Documentation + text: Start Here link: /overview/ + - theme: alt + text: First Boot + link: /tutorials - theme: alt text: Releases link: /reference/releases/ @@ -21,6 +21,17 @@ hero: alt: Garden Linux Logo features: + ### # use cases + ### - title: Container Runtime + ### details: The preferred Kubernetes worker node for 90% of cloud applications deployed with Gardener + ### link: /overview/ + ### - title: Container Base Images + ### details: Package applications according to the OCI specification + ### link: /how-to/container-base-image + ### - title: Virtual Machine Host + ### details: OS for deploying hypervisor nodes to run Kubernetes nodes + ### link: /tutorials/ + # documentation - title: Tutorials details: Step-by-step walkthroughs to get you started with Garden Linux link: /tutorials/ @@ -37,9 +48,6 @@ features: details: Guides for contributing to Garden Linux documentation and development link: /contributing/ - title: Releases - details: Overiew which Graden Linux Releases are available + details: Overview which Garden Linux Releases are available link: /reference/releases/ - # - title: Legacy Documentation - # details: Aggregated documentation from source repositories (being migrated) - # link: /projects/gardenlinux/introduction/index --- diff --git a/docs/overview/index.md b/docs/overview/index.md index b6d4e02..6c3cae5 100644 --- a/docs/overview/index.md +++ b/docs/overview/index.md @@ -4,7 +4,21 @@ description: "How Garden Linux documentation is organized" order: 1 --- -# Documentation Overview +# Garden Linux + +## Mission Statement + +Garden Linux (GL) is a Debian Linux derivative built with three main goals: fully open source, ease-of-use & purpose-optimized! + +It is **not** a general-purpose Operating System targeting all possible use-cases & scenarios. + +Instead, it is built to serve as: + +- **Container runtime** — The preferred Kubernetes worker node for 90% of the cloud applications deployed with Gardener +- **Container base images** — Our solution for packaging applications according to the OCI specification +- **Virtual machine hypervisor host** — OS used to deploy hypervisor nodes to run Kubernetes nodes + +## Documentation Overview Garden Linux documentation uses the [Diátaxis framework](https://diataxis.fr/) to organize content by what you need, not by your role. This page explains the structure and helps you find the right section. diff --git a/repos-config.json b/repos-config.json index b175f34..d9ccd2d 100644 --- a/repos-config.json +++ b/repos-config.json @@ -6,7 +6,7 @@ "docs_path": "docs", "target_path": "projects/gardenlinux", "ref": "docs-ng", - "commit": "4c1d90299cef6cd9db3e800cdd9668949dc8ebec", + "commit": "235ee3265e3d7363146769f07b1fab14586eb2aa", "root_files": [ "CONTRIBUTING.md", "SECURITY.md", @@ -21,7 +21,11 @@ "reference": "reference", "contributing": "contributing" }, - "media_directories": [".media", "assets", "_static"] + "media_directories": [ + ".media", + "assets", + "_static" + ] }, { "name": "builder", @@ -30,7 +34,11 @@ "target_path": "projects/builder", "ref": "docs-ng", "commit": "086e74ff032c5f2a05989aef4f20ba69f94bdbf9", - "media_directories": [".media", "assets", "_static"] + "media_directories": [ + ".media", + "assets", + "_static" + ] }, { "name": "python-gardenlinux-lib", @@ -40,7 +48,11 @@ "ref": "docs-ng", "commit": "9142fccc3d83ab51759db7d328fa19166bc1df63", "structure": "sphinx", - "media_directories": [".media", "assets", "_static"] + "media_directories": [ + ".media", + "assets", + "_static" + ] }, { "name": "package-linux", @@ -49,7 +61,11 @@ "target_path": "projects/package-linux", "ref": "docs-ng", "commit": "841139441357a222ea10349f6d09a875ce9732d1", - "media_directories": [".media", "assets", "_static"] + "media_directories": [ + ".media", + "assets", + "_static" + ] }, { "name": "glrd", @@ -58,7 +74,11 @@ "target_path": "projects/glrd", "ref": "docs-ng", "commit": "c444721b728c0be0de2c19a0bc328928a0091d65", - "media_directories": [".media", "assets", "_static"] + "media_directories": [ + ".media", + "assets", + "_static" + ] } ] }