Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 18 additions & 10 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/
Expand All @@ -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/
Expand All @@ -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
---
16 changes: 15 additions & 1 deletion docs/overview/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
20 changes: 0 additions & 20 deletions docs/tutorials/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
:::

<SectionIndex />

## About Tutorials
Expand Down
32 changes: 26 additions & 6 deletions repos-config.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"docs_path": "docs",
"target_path": "projects/gardenlinux",
"ref": "docs-ng",
"commit": "4c1d90299cef6cd9db3e800cdd9668949dc8ebec",
"commit": "235ee3265e3d7363146769f07b1fab14586eb2aa",
"root_files": [
"CONTRIBUTING.md",
"SECURITY.md",
Expand All @@ -21,7 +21,11 @@
"reference": "reference",
"contributing": "contributing"
},
"media_directories": [".media", "assets", "_static"]
"media_directories": [
".media",
"assets",
"_static"
]
},
{
"name": "builder",
Expand All @@ -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",
Expand All @@ -40,7 +48,11 @@
"ref": "docs-ng",
"commit": "9142fccc3d83ab51759db7d328fa19166bc1df63",
"structure": "sphinx",
"media_directories": [".media", "assets", "_static"]
"media_directories": [
".media",
"assets",
"_static"
]
},
{
"name": "package-linux",
Expand All @@ -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",
Expand All @@ -58,7 +74,11 @@
"target_path": "projects/glrd",
"ref": "docs-ng",
"commit": "c444721b728c0be0de2c19a0bc328928a0091d65",
"media_directories": [".media", "assets", "_static"]
"media_directories": [
".media",
"assets",
"_static"
]
}
]
}
Loading