From 85a079443d574efa0f456ba561648d11638882ce Mon Sep 17 00:00:00 2001
From: Cassidy James <cassidyjames@roost.tools>
Date: Tue, 12 May 2026 12:27:18 -0600
Subject: [PATCH] documentation: versioning (#57)

---
 documentation.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/documentation.md b/documentation.md
index f99020e..bd68dfe 100644
--- a/documentation.md
+++ b/documentation.md
@@ -81,7 +81,12 @@ Unless there is a need for specific HTML attributes, use Markdown to reference i
 
 ## Docs website
 
-Projects should generate a web version of the documentation and deploy with GitHub Pages. By default, this will be available at **roostorg.github.io/`<project>`** where `<project>` is the GitHub repository name.
+Projects should generate a web version of the documentation and deploy with GitHub Pages. By default, this will be available at **roostorg.github.io/`<project>`** where `<project>` is the GitHub repository name. For projects that have documentation that may change between versioned releases, docs websites should support versioning; for example:
+
+- `main` branch at **roostorg.github.io/`<project>`/latest/**
+- `0.1` tag at **roostorg.github.io/`<project>`/0.1/**
+- `0.2` tag at **roostorg.github.io/`<project>`/0.2/**
+- etc.
 
 <!-- TODO: mention mdBook if we're happy with it! -->
 
-- 
2.51.2