Explanation
Explanations are understanding-oriented discussions that clarify and illuminate concepts. They provide background, context, and deeper insight into how and why Garden Linux works the way it does.
Available Explanation documentation
Use CasesWhen and why to choose Garden Linux for your workload
Architecture1524-Meters View of Garden Linux
Architectural DecisionsGet to know important architectural decisions
Release HierarchyOverview of Garden Linux Release Hierarchy
PackagingUnderstand how Garden Linux packages are built and built using the package-build tools
Package SourcesLearn about different types of Garden Linux Package Sources
Repository InfrastructureUnderstand how Garden Linux assembles, distributes, and releases packages through its repository infrastructure
OS ReleasesUnderstanding Garden Linux OS release artifacts, distribution channels, and orchestration
KernelWhy we build the Garden Linux Kernel the way we build it
FlavorsConceptual explanation of Garden Linux's flavor system and its role in image creation
Container Base ImageUnderstanding Garden Linux full and bare (distroless-style) OCI container images
Semantic VersioningHow we Version Garden Linux Releases
GitHub Actions WorkflowsExplanation of the GitHub Actions workflows used to build, test, and publish nightly and versioned Garden Linux releases
Boot ModesUnderstanding Legacy and USI boot modes in Garden Linux
Secure Boot and Trusted BootHow Secure Boot and Trusted Boot protect the Garden Linux boot chain
TestingLearn how Testing of Garden Linux works
Test Framework ArchitectureUnderstanding the Garden Linux Test Framework Architecture
Test OrganizationUnderstanding how Garden Linux tests are organized and structured
About Explanations: Following the Diátaxis framework, explanations help you understand the bigger picture. They explore topics in depth, discuss alternatives, and explain design decisions. Explanations are ideal when you want to deepen your knowledge and understanding of Garden Linux.