Browse by Persona

Target audience: All users Goal: Find documentation relevant to your role.

Developer

For users who want to build, run, or verify StageX packages.

Add a New Package to StageX -- Create package definitions for new dependencies.
Advanced: Rust CI Pipeline with StageX -- Build a real Rust tool through a 4-stage CI pipeline.
Build a C/C++ Application -- Build a reproducible C/C++ binary using LLVM/Clang or GCC.
Build a Go Application -- Build a reproducible Go binary using pallet-go.
Build a Node.js Application -- Build a reproducible Node.js application using pallet-nodejs.
Build a Python Application -- Build a reproducible Python application using pallet-python.
Build a Rust Application -- Build a reproducible Rust binary with external crate dependencies.
Changelog -- Record of notable changes organized by release version.
Containerfile Syntax -- StageX-specific Containerfile patterns.
Cross-Compile for Other Architectures -- Build packages for linux/arm64 and other platforms.
FAQ -- Answers to common questions.
Glossary -- Definitions of StageX-specific terminology.
How-To Guides -- Section overview of problem-solving guides.
License -- Licensing information (ISC).
OCI-Native Package Management -- OCI container images as the native package format.
Package Catalog -- Listing of all packages by stage.
Project -- Section overview of project information.
Quick Start: Your First Reproducible Build -- Build and verify a reproducible Rust binary.
Reference -- Section overview of technical reference.
Reproduce Builds Locally -- Verify bit-for-bit reproducibility of builds.
Reproducible Builds & Supply Chain Integrity -- How reproducibility enables trust.
Roadmap -- Upcoming features and strategic direction.
Set Up a Development Environment -- Configure your machine for StageX development.
StageX Documentation -- Home page and quick-start navigation.
Troubleshooting -- Diagnose and resolve common issues.
Tutorials -- Section overview of learning-oriented guides.
Understanding Full-Source Bootstrapping -- The bootstrap chain from 181-byte seed to modern toolchain.
Use StageX with OCI Runtimes -- Integrate with Docker, Podman, and Kubernetes.
Verify Multi-Signature Attestations -- Validate GPG multi-signature attestations.
Verifying Your First StageX Image -- Pull, verify multi-sig, and understand the quorum model.

Maintainer

For StageX project contributors who create or maintain packages.

Add a New Package to StageX -- Create package definitions for new dependencies.
Architecture Specification -- Technical specification of the bootstrap chain.
Changelog -- Record of notable changes by release version.
Code of Conduct -- Community standards and expectations.
Containerfile Syntax -- StageX-specific Containerfile patterns.
Contributing -- Section overview of contribution information.
Contributor Guide -- Package structure, build system, and PR workflow.
Explanation -- Section overview of conceptual documentation.
FAQ -- Answers to common questions about building and contributing.
Glossary -- Terminology definitions.
How-To Guides -- Section overview of problem-solving guides.
License -- Licensing information.
Maintainer's Handbook -- Maintainer responsibilities, processes, and standards.
Makefile Targets & Environment -- Full reference for build targets and variables.
Package Catalog -- Complete listing of all packages by stage.
Package.toml Format -- Full reference for package metadata format.
Project -- Section overview of project information.
Reference -- Section overview of technical reference.
Release Process -- How releases are created, signed, and published.
Reproducible Builds & Supply Chain Integrity -- How reproducibility is achieved and verified.
Roadmap -- Upcoming features and strategic direction.
Set Up a Development Environment -- Configure your machine for StageX development.
StageX Documentation -- Home page and navigation overview.
Style Guide -- Documentation conventions and formatting standards.
Troubleshooting -- Diagnose and resolve common issues.
Tutorials -- Section overview of learning-oriented guides.
Upgrade a Package -- Update a package to latest version.

Security Auditor

For reviewers focused on trust models, signing infrastructure, and supply chain verification.

Decentralized Multi-Sig Signing -- Quorum-based multi-signer attestations using PGP.
Explanation -- Section overview of conceptual documentation.
Reproduce Builds Locally -- Verify bit-for-bit reproducibility against published digests.
Reproducible Builds & Supply Chain Integrity -- Three levels of build determinism and accountability.
StageX Documentation -- Home page and navigation overview.
Trust Models: Decentralized vs Distributed vs Centralized -- Comparison of trust architectures and StageX's quorum design.
Understanding Full-Source Bootstrapping -- The complete bootstrap chain and Trusting Trust defense.
Verify Multi-Signature Attestations -- Validate GPG multi-signature attestations on artifacts.
Verifying Your First StageX Image -- Pull, verify, and understand the verification workflow.
Why Full-Source Bootstrapping Matters -- The Trusting Trust attack and why bootstrapping is the only defense.

Evaluator

For users comparing StageX against alternatives or evaluating adoption.

Architecture Specification -- Technical specification of the bootstrap chain.
Changelog -- Record of notable changes by release version.
Decentralized Multi-Sig Signing -- Quorum-based signing and key management.
Explanation -- Section overview of conceptual documentation.
FAQ -- Answers to common evaluation questions.
Glossary -- Terminology definitions.
License -- Licensing information.
Minimalism as a Security Strategy -- How musl, FROM scratch, and static linking reduce attack surface.
OCI-Native Package Management -- OCI layers as native package format.
Package Catalog -- Complete listing of all packages by stage.
Project -- Section overview of project information.
Reference -- Section overview of technical reference.
Reproducible Builds & Supply Chain Integrity -- How reproducibility transforms trust.
Roadmap -- Upcoming features and strategic direction.
StageX Documentation -- Home page and navigation overview.
StageX vs Alternatives -- Comprehensive comparison against Guix, Alpine, NixOS, Wolfi, and others.
Troubleshooting -- Diagnose common evaluation issues.
Trust Models: Decentralized vs Distributed vs Centralized -- Analysis of trust architectures.
Tutorials -- Section overview of learning-oriented guides.
Understanding Full-Source Bootstrapping -- The full bootstrap chain explained.
Why Full-Source Bootstrapping Matters -- The Trusting Trust attack and defense.
Why LLVM/Clang -- Rationale for LLVM as default toolchain.

Contributor

For documentation contributors specifically.

Pages tagged contributor overlap with maintainer content. See the Maintainer section for the comprehensive list of contribution-related pages.

Style Guide -- Documentation conventions and formatting standards.
Why LLVM/Clang -- Technical rationale for toolchain decisions.