clockworklabs · gefjon · Dec 9, 2025 · Dec 8, 2025 · Dec 9, 2025 · Dec 9, 2025
diff --git a/docs/README.md b/docs/README.md
@@ -53,6 +53,19 @@ For more information on how to use Docusaurus, see the
 3. Install the dependencies: `pnpm install`
 4. Run the development server: `pnpm dev`, which will start a local server and open a browser window.
    All changes you make to the markdown files will be reflected live in the browser.
+
+### Adding new pages
+
+All of our directory and file names are prefixed with a five-digit number which determines how they're sorted. 
+We started with the hundreds place as the smallest significant digit, to allow using the tens and ones places to add new pages between.
+When adding a new page in between two existing pages, choose a number which:
+
+- Doesn't use any more significant figures than it needs to.
+- Is approximately halfway between the previous and next page.
+
+For example, if you want to add a new page between `00300-foo` and `00400-bar`, name it `00350-baz`. To add a new page between `00350-baz` and `00400-bar`, prefer `00370-quux` or `00380-quux`, rather than `00375-quux`, to avoid populating the ones place.
+
+To add a new page after all previous pages, use the smallest multiple of 100 larger than all other pages. For example, if the highest-numbered existing page is `01350-abc`, create `01400-def`.
 
 ## License
 

diff --git a/docs/docs/00-ask-ai/01-ask-ai.mdx → docs/docs/00000-ask-ai/00100-ask-ai.mdx b/docs/docs/00-ask-ai/01-ask-ai.mdx → docs/docs/00000-ask-ai/00100-ask-ai.mdx
diff --git a/docs/docs/00-ask-ai/_category_.json → docs/docs/00000-ask-ai/_category_.json b/docs/docs/00-ask-ai/_category_.json → docs/docs/00000-ask-ai/_category_.json
diff --git a/docs/docs/01-intro/01-overview.md → docs/docs/00100-intro/00100-overview.md b/docs/docs/01-intro/01-overview.md → docs/docs/00100-intro/00100-overview.md
diff --git a/docs/docs/01-intro/02-getting-started.md → ...docs/00100-intro/00200-getting-started.md b/docs/docs/01-intro/02-getting-started.md → ...docs/00100-intro/00200-getting-started.md
diff --git a/docs/docs/02-quickstarts/01-typescript.md → ...ocs/00200-quickstarts/00100-typescript.md b/docs/docs/02-quickstarts/01-typescript.md → ...ocs/00200-quickstarts/00100-typescript.md
diff --git a/docs/docs/02-quickstarts/02-c-sharp.md → docs/docs/00200-quickstarts/00200-c-sharp.md b/docs/docs/02-quickstarts/02-c-sharp.md → docs/docs/00200-quickstarts/00200-c-sharp.md
diff --git a/docs/docs/02-quickstarts/03-rust.md → docs/docs/00200-quickstarts/00300-rust.md b/docs/docs/02-quickstarts/03-rust.md → docs/docs/00200-quickstarts/00300-rust.md
diff --git a/docs/docs/02-unreal-tutorial/01-overview.md → ...s/00250-unreal-tutorial/00100-overview.md b/docs/docs/02-unreal-tutorial/01-overview.md → ...s/00250-unreal-tutorial/00100-overview.md
diff --git a/docs/docs/02-unreal-tutorial/02-part-1.md → ...ocs/00250-unreal-tutorial/00200-part-1.md b/docs/docs/02-unreal-tutorial/02-part-1.md → ...ocs/00250-unreal-tutorial/00200-part-1.md
diff --git a/docs/docs/02-unreal-tutorial/03-part-2.md → ...ocs/00250-unreal-tutorial/00300-part-2.md b/docs/docs/02-unreal-tutorial/03-part-2.md → ...ocs/00250-unreal-tutorial/00300-part-2.md
diff --git a/docs/docs/02-unreal-tutorial/04-part-3.md → ...ocs/00250-unreal-tutorial/00400-part-3.md b/docs/docs/02-unreal-tutorial/04-part-3.md → ...ocs/00250-unreal-tutorial/00400-part-3.md
diff --git a/docs/docs/02-unreal-tutorial/05-part-4.md → ...ocs/00250-unreal-tutorial/00500-part-4.md b/docs/docs/02-unreal-tutorial/05-part-4.md → ...ocs/00250-unreal-tutorial/00500-part-4.md
diff --git a/docs/docs/02-unreal-tutorial/_category_.json → ...ocs/00250-unreal-tutorial/_category_.json b/docs/docs/02-unreal-tutorial/_category_.json → ...ocs/00250-unreal-tutorial/_category_.json
diff --git a/docs/docs/03-unity-tutorial/01-overview.md → ...cs/00300-unity-tutorial/00100-overview.md b/docs/docs/03-unity-tutorial/01-overview.md → ...cs/00300-unity-tutorial/00100-overview.md
diff --git a/docs/docs/03-unity-tutorial/02-part-1.md → ...docs/00300-unity-tutorial/00200-part-1.md b/docs/docs/03-unity-tutorial/02-part-1.md → ...docs/00300-unity-tutorial/00200-part-1.md
diff --git a/docs/docs/03-unity-tutorial/03-part-2.md → ...docs/00300-unity-tutorial/00300-part-2.md b/docs/docs/03-unity-tutorial/03-part-2.md → ...docs/00300-unity-tutorial/00300-part-2.md
diff --git a/docs/docs/03-unity-tutorial/04-part-3.md → ...docs/00300-unity-tutorial/00400-part-3.md b/docs/docs/03-unity-tutorial/04-part-3.md → ...docs/00300-unity-tutorial/00400-part-3.md
diff --git a/docs/docs/03-unity-tutorial/05-part-4.md → ...docs/00300-unity-tutorial/00500-part-4.md b/docs/docs/03-unity-tutorial/05-part-4.md → ...docs/00300-unity-tutorial/00500-part-4.md
diff --git a/docs/docs/03-unity-tutorial/_category_.json → ...docs/00300-unity-tutorial/_category_.json b/docs/docs/03-unity-tutorial/_category_.json → ...docs/00300-unity-tutorial/_category_.json
diff --git a/docs/docs/04-deploying/01-maincloud.md → docs/docs/00400-deploying/00100-maincloud.md b/docs/docs/04-deploying/01-maincloud.md → docs/docs/00400-deploying/00100-maincloud.md
diff --git a/docs/docs/04-deploying/02-self-hosting.md → ...ocs/00400-deploying/00200-self-hosting.md b/docs/docs/04-deploying/02-self-hosting.md → ...ocs/00400-deploying/00200-self-hosting.md
diff --git a/...docs/05-cli-reference/01-cli-reference.md → ...0500-cli-reference/00100-cli-reference.md b/...docs/05-cli-reference/01-cli-reference.md → ...0500-cli-reference/00100-cli-reference.md
diff --git a/.../05-cli-reference/02-standalone-config.md → ...-cli-reference/00200-standalone-config.md b/.../05-cli-reference/02-standalone-config.md → ...-cli-reference/00200-standalone-config.md
diff --git a/docs/docs/05-cli-reference/_category_.json → .../docs/00500-cli-reference/_category_.json b/docs/docs/05-cli-reference/_category_.json → .../docs/00500-cli-reference/_category_.json
diff --git a/...06-server-module-languages/01-overview.md → ...server-module-languages/00100-overview.md b/...06-server-module-languages/01-overview.md → ...server-module-languages/00100-overview.md
diff --git a/...ver-module-languages/02-rust-reference.md → ...-module-languages/00200-rust-reference.md b/...ver-module-languages/02-rust-reference.md → ...-module-languages/00200-rust-reference.md
diff --git a/...r-module-languages/03-csharp-reference.md → ...odule-languages/00300-csharp-reference.md b/...r-module-languages/03-csharp-reference.md → ...odule-languages/00300-csharp-reference.md
diff --git a/...dule-languages/04-typescript-reference.md → ...e-languages/00400-typescript-reference.md b/...dule-languages/04-typescript-reference.md → ...e-languages/00400-typescript-reference.md
diff --git a/...6-server-module-languages/_category_.json → ...0-server-module-languages/_category_.json b/...6-server-module-languages/_category_.json → ...0-server-module-languages/_category_.json
diff --git a/...cs/07-client-sdk-languages/01-overview.md → ...00-client-sdk-languages/00100-overview.md b/...cs/07-client-sdk-languages/01-overview.md → ...00-client-sdk-languages/00100-overview.md
diff --git a/...ient-sdk-languages/02-csharp-reference.md → ...t-sdk-languages/00200-csharp-reference.md b/...ient-sdk-languages/02-csharp-reference.md → ...t-sdk-languages/00200-csharp-reference.md
diff --git a/...client-sdk-languages/03-rust-reference.md → ...ent-sdk-languages/00300-rust-reference.md b/...client-sdk-languages/03-rust-reference.md → ...ent-sdk-languages/00300-rust-reference.md
diff --git a/...-sdk-languages/04-typescript-reference.md → ...k-languages/00400-typescript-reference.md b/...-sdk-languages/04-typescript-reference.md → ...k-languages/00400-typescript-reference.md
diff --git a/...ient-sdk-languages/05-unreal-reference.md → ...t-sdk-languages/00500-unreal-reference.md b/...ient-sdk-languages/05-unreal-reference.md → ...t-sdk-languages/00500-unreal-reference.md
diff --git a/...s/07-client-sdk-languages/_category_.json → ...0700-client-sdk-languages/_category_.json b/...s/07-client-sdk-languages/_category_.json → ...0700-client-sdk-languages/_category_.json
diff --git a/docs/docs/08-sql/01-sql-reference.md → docs/docs/00800-sql/00100-sql-reference.md b/docs/docs/08-sql/01-sql-reference.md → docs/docs/00800-sql/00100-sql-reference.md
diff --git a/docs/docs/08-sql/02-pg-wire.md → docs/docs/00800-sql/00200-pg-wire.md b/docs/docs/08-sql/02-pg-wire.md → docs/docs/00800-sql/00200-pg-wire.md
diff --git a/...ubscriptions/01-subscription-reference.md → ...criptions/00100-subscription-reference.md b/...ubscriptions/01-subscription-reference.md → ...criptions/00100-subscription-reference.md
diff --git a/...ubscriptions/02-subscription-semantics.md → ...criptions/00200-subscription-semantics.md b/...ubscriptions/02-subscription-semantics.md → ...criptions/00200-subscription-semantics.md
diff --git a/...read-permissions/01-row-level-security.md → ...d-permissions/00100-row-level-security.md b/...read-permissions/01-row-level-security.md → ...d-permissions/00100-row-level-security.md
diff --git a/.../docs/10-read-permissions/_category_.json → ...cs/01000-read-permissions/_category_.json b/.../docs/10-read-permissions/_category_.json → ...cs/01000-read-permissions/_category_.json
diff --git a/docs/docs/11-Procedures/01-overview.md → docs/docs/01100-procedures/00100-overview.md b/docs/docs/11-Procedures/01-overview.md → docs/docs/01100-procedures/00100-overview.md
diff --git a/...cs/12-how-to/01-incremental-migrations.md → ...00-how-to/00100-incremental-migrations.md b/...cs/12-how-to/01-incremental-migrations.md → ...00-how-to/00100-incremental-migrations.md
diff --git a/...12-how-to/02-reject-client-connections.md → ...how-to/00200-reject-client-connections.md b/...12-how-to/02-reject-client-connections.md → ...how-to/00200-reject-client-connections.md
diff --git a/docs/docs/12-how-to/03-using-auth-claims.md → ...s/01200-how-to/00300-using-auth-claims.md b/docs/docs/12-how-to/03-using-auth-claims.md → ...s/01200-how-to/00300-using-auth-claims.md
diff --git a/docs/docs/12-how-to/_category_.json → docs/docs/01200-how-to/_category_.json b/docs/docs/12-how-to/_category_.json → docs/docs/01200-how-to/_category_.json
diff --git a/docs/docs/13-spacetimeauth/01-overview.md → ...cs/01300-spacetime-auth/00100-overview.md b/docs/docs/13-spacetimeauth/01-overview.md → ...cs/01300-spacetime-auth/00100-overview.md
diff --git a/...13-spacetimeauth/02-creating-a-project.md → ...pacetime-auth/00200-creating-a-project.md b/...13-spacetimeauth/02-creating-a-project.md → ...pacetime-auth/00200-creating-a-project.md
diff --git a/...spacetimeauth/03-configuring-a-project.md → ...etime-auth/00300-configuring-a-project.md b/...spacetimeauth/03-configuring-a-project.md → ...etime-auth/00300-configuring-a-project.md
diff --git a/docs/docs/13-spacetimeauth/04-testing.md → ...ocs/01300-spacetime-auth/00400-testing.md b/docs/docs/13-spacetimeauth/04-testing.md → ...ocs/01300-spacetime-auth/00400-testing.md
diff --git a/.../13-spacetimeauth/05-react-integration.md → ...spacetime-auth/00500-react-integration.md b/.../13-spacetimeauth/05-react-integration.md → ...spacetime-auth/00500-react-integration.md
diff --git a/docs/docs/14-http-api/01-authorization.md → ...ocs/01400-http-api/00100-authorization.md b/docs/docs/14-http-api/01-authorization.md → ...ocs/01400-http-api/00100-authorization.md
diff --git a/docs/docs/14-http-api/02-identity.md → docs/docs/01400-http-api/00200-identity.md b/docs/docs/14-http-api/02-identity.md → docs/docs/01400-http-api/00200-identity.md
diff --git a/docs/docs/14-http-api/03-database.md → docs/docs/01400-http-api/00300-database.md b/docs/docs/14-http-api/03-database.md → docs/docs/01400-http-api/00300-database.md
diff --git a/docs/docs/14-http-api/_category_.json → docs/docs/01400-http-api/_category_.json b/docs/docs/14-http-api/_category_.json → docs/docs/01400-http-api/_category_.json
diff --git a/...s/15-internals/01-module-abi-reference.md → ...0-internals/00100-module-abi-reference.md b/...s/15-internals/01-module-abi-reference.md → ...0-internals/00100-module-abi-reference.md
diff --git a/docs/docs/15-internals/02-sats-json.md → docs/docs/01500-internals/00200-sats-json.md b/docs/docs/15-internals/02-sats-json.md → docs/docs/01500-internals/00200-sats-json.md
diff --git a/docs/docs/15-internals/03-bsatn.md → docs/docs/01500-internals/00300-bsatn.md b/docs/docs/15-internals/03-bsatn.md → docs/docs/01500-internals/00300-bsatn.md
diff --git a/docs/docs/16-appendix/index.md → docs/docs/01600-appendix/00100-index.md b/docs/docs/16-appendix/index.md → docs/docs/01600-appendix/00100-index.md
diff --git a/smoketests/tests/quickstart.py b/smoketests/tests/quickstart.py
@@ -200,8 +200,8 @@ def _test_quickstart(self):
 
 class Rust(BaseQuickstart):
     lang = "rust"
-    server_doc = STDB_DIR / "docs/docs/02-quickstarts/03-rust.md"
-    client_doc = STDB_DIR / "docs/docs/02-quickstarts/03-rust.md"
+    server_doc = STDB_DIR / "docs/docs/00200-quickstarts/00300-rust.md"
+    client_doc = STDB_DIR / "docs/docs/00200-quickstarts/00300-rust.md"
     server_file = "src/lib.rs"
     client_file = "src/main.rs"
     module_bindings = "src/module_bindings"
@@ -249,8 +249,8 @@ def test_quickstart(self):
 
 class CSharp(BaseQuickstart):
     lang = "csharp"
-    server_doc = STDB_DIR / "docs/docs/02-quickstarts/02-c-sharp.md"
-    client_doc = STDB_DIR / "docs/docs/02-quickstarts/02-c-sharp.md"
+    server_doc = STDB_DIR / "docs/docs/00200-quickstarts/00200-c-sharp.md"
+    client_doc = STDB_DIR / "docs/docs/00200-quickstarts/00200-c-sharp.md"
     server_file = "Lib.cs"
     client_file = "Program.cs"
     module_bindings = "module_bindings"
@@ -362,7 +362,7 @@ def test_quickstart(self):
 class TypeScript(Rust):
     lang = "typescript"
     client_lang = "rust"
-    server_doc = STDB_DIR / "docs/docs/02-quickstarts/01-typescript.md"
+    server_doc = STDB_DIR / "docs/docs/00200-quickstarts/00100-typescript.md"
     server_file = "src/index.ts"
 
     def server_postprocess(self, server_path: Path):