WordPress · jonathanbossenger · Oct 21, 2025 · Oct 14, 2025 · Oct 14, 2025 · Oct 14, 2025
diff --git a/README.md b/README.md
@@ -16,16 +16,9 @@
 3. **Security‑first** - explicit permissions determine who/what may invoke an ability.
 4. **Gradual adoption** - ships first as a Composer package, migrates smoothly to core.
 
-## Developer Documentation
-
-- [Introduction](docs/1.intro.md)
-- [Getting Started](docs/2.getting-started.md)
-- [Registering Abilities](docs/3.registering-abilities.md)
-- [Using Abilities](docs/4.using-abilities.md)
-- [REST API Reference](docs/5.rest-api.md)
-- [Hooks](docs/6.hooks.md)
-- [JavaScript/TypeScript Client](docs/7.javascript-client.md)
-- [Contributing Guidelines](CONTRIBUTING.md)
+## Documentation
+
+- **[Developer docs](docs/README.md)**.
 
 ## Inspiration
 

diff --git a/docs/4.using-abilities.md b/docs/4.using-abilities.md
diff --git a/docs/7.registering-categories.md b/docs/7.registering-categories.md
diff --git a/docs/README.md b/docs/README.md
@@ -0,0 +1,8 @@
+# Developer Documentation
+
+- [Introduction](intro.md)
+- [Getting Started](getting-started.md)
+- [PHP API Reference](php-api.md)
+- [REST API Reference](rest-api.md)
+- [JavaScript Client](javascript-client.md)
+- [Hooks](hooks.md)
diff --git a/docs/2.getting-started.md → docs/getting-started.md b/docs/2.getting-started.md → docs/getting-started.md