istio.io is a website repository that hosts the documentation and public-facing content for the Istio service mesh project.
The repository serves as the source for multiple site variations that address different user needs within the Istio ecosystem. It maintains istio.io for current release documentation, preliminary.istio.io for next-release documentation under active development, and archive.istio.io for snapshots of previous release documentation. This multi-version approach allows users on different Istio versions to access relevant documentation without confusion.
The tool is essential for anyone contributing to Istio's documentation or maintaining the project's public presence. It suits organizations that need to document multiple concurrent versions of a product and want to keep development documentation separate from stable release documentation. The repository uses a branching strategy where the master branch feeds preliminary.istio.io automatically, while istio.io pulls from release branches, allowing teams to manage documentation lifecycles independently from product releases. Users can navigate between site variations through a menu, making it straightforward to switch between current, upcoming, and archived versions.
The project maintains active deployment pipelines for all three site variations through Netlify, with automated builds triggered by commits to their respective branches. Documentation changes to the master branch automatically propagate to the preliminary site, while updates to release branches control what appears on the main istio.io site. The repository includes tooling for testing document content and supports multi-language documentation, indicating ongoing investment in accessibility and internationalization. Regular maintenance procedures are documented alongside contribution guidelines that direct users to the main Istio project repository for broader context.
