diff --git a/.claude/docs/documentation.md b/.claude/docs/documentation.md index 6b2ee98..d28bed8 100644 --- a/.claude/docs/documentation.md +++ b/.claude/docs/documentation.md @@ -7,7 +7,15 @@ Both `README.md` and `docs/REFERENCE.md` use back-to-top navigation after each m 1. Add `
` before the `---` that closes the section 2. Update the Table of Contents with the new entry -## Overview File Structure +## Breadcrumb Navigation + +Both `docs/REFERENCE.md` and all `docs/overview/` files use header and footer nav blocks with `Previous`/`Next` links wrapped in `` tags. + +### REFERENCE.md + +Uses the same layout as overview files (header nav → `---` → content → `---` → footer nav). Its `Previous` links to `../README.md#-table-of-contents-` and `Next` links to `overview/010_KEY_CONCEPTS.md`. + +### Overview Files Each file in `docs/overview/` follows this layout: @@ -17,7 +25,7 @@ Each file in `docs/overview/` follows this layout: 4. **`---`** separator 5. **Footer nav** — `` block with the same `` `Previous` ``/`` `Next` `` links as the header -Navigation chain: `010_KEY_CONCEPTS` → `020_BASIC_USAGE` → … → `100_PORTS_AND_ADAPTERS`. The first file's `Previous` links to `../README.md#further-reading`; the last file's `Next` links to `../REFERENCE.md`. +Navigation chain: `010_KEY_CONCEPTS` → `020_BASIC_USAGE` → … → `100_PORTS_AND_ADAPTERS`. The first file's `Previous` links to `../../README.md#-table-of-contents-`; the last file's `Next` links to `../REFERENCE.md`. When adding a new overview file: diff --git a/README.md b/README.md index a84c510..796800d 100644 --- a/README.md +++ b/README.md @@ -16,9 +16,9 @@ ## 📚 Table of Contents - [💡 Introduction](#-introduction) -- [🚀 Getting Started](#-getting-started) - [📦 Installation](#-installation) - [🏗️ The Basic Structure](#️-the-basic-structure) +- [🚀 Getting Started](#-getting-started) - [🗂️ Documentation](#️-documentation) - [🛠️ Development](#️-development) - [🤝 Contributing](#-contributing) @@ -81,21 +81,6 @@ You can also check the [examples](examples) directory for more simple examples o -## 🚀 Getting Started - -**New to Solid::Process?** The comprehensive [Reference Guide](docs/REFERENCE.md) covers everything you need to know: - -- ✅ Step-by-step tutorial from basics to advanced -- ✅ Real-world examples (User Registration system) -- ✅ All features explained with working code -- ✅ Perfect for developers AND AI coding agents - -> **🤖 AI Agents:** Point your coding assistant to [`docs/REFERENCE.md`](docs/REFERENCE.md) for complete API knowledge and patterns, or explore the [AI-Powered Wiki](https://deepwiki.com/solid-process/solid-process) for visual diagrams and interactive Q&A. - -**Start Learning →** [Reference Guide](docs/REFERENCE.md) | [Quick Overview](docs/overview/010_KEY_CONCEPTS.md) - - - ## 📦 Installation Install the gem and add to the application's Gemfile by executing: @@ -144,7 +129,16 @@ result[:user] # => #