Merge pull request #15 from solid-process/chore/docs-enhancements

serradura · web-flow · commit 90e9ed22d401 · 2026-01-29T10:09:08.000-03:00
Docs enhancements
diff --git a/.gitignore b/.gitignore
@@ -18,3 +18,4 @@ gemfiles/.bundle/
 .tool-versions
 
 /.claude/settings.local.json
+/docs/plans/
diff --git a/README.md b/README.md
@@ -5,6 +5,8 @@
     <a href="https://deepwiki.com/solid-process/solid-process"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
     <a href="https://qlty.sh/gh/solid-process/projects/solid-process"><img src="https://qlty.sh/gh/solid-process/projects/solid-process/maintainability.svg" alt="Maintainability" /></a>
     <a href="https://qlty.sh/gh/solid-process/projects/solid-process"><img src="https://qlty.sh/gh/solid-process/projects/solid-process/coverage.svg" alt="Code Coverage" /></a>
+    <br/>
+    <a href="https://badge.fury.io/rb/solid-process"><img src="https://badge.fury.io/rb/solid-process.svg" alt="Gem Version" height="18"></a>
     <img src="https://img.shields.io/badge/Ruby%20%3E%3D%202.7%2C%20%3C%3D%20Head-ruby.svg?colorA=444&colorB=333" alt="Ruby">
     <img src="https://img.shields.io/badge/Rails%20%3E%3D%206.0%2C%20%3C%3D%20Edge-rails.svg?colorA=444&colorB=333" alt="Rails">
   </p>
@@ -87,7 +89,7 @@ You can also check the [examples](examples) directory for more simple examples o
 - ✅ 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.
+> **🤖 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 →**](docs/REFERENCE.md)
 
@@ -150,7 +152,7 @@ See the [Reference Guide](docs/REFERENCE.md) for detailed explanations, validati
 > [!TIP]
 > **[Full Reference →](docs/REFERENCE.md)** — Complete guide covering every feature with detailed examples.
 >
-> _**Perfect for developers and AI coding agents**._
+> **[AI-Powered Wiki →](https://deepwiki.com/solid-process/solid-process)** — Visual diagrams, architecture flows, and interactive Q&A beyond the official docs.
 
 **Quick Overview** — Bite-sized guides for each topic:
 
diff --git a/docs/REFERENCE.md b/docs/REFERENCE.md
@@ -1,4 +1,4 @@
-# Getting Started with Solid::Process
+# Solid::Process — Reference Guide
 
 This guide teaches everything you need to know about Solid::Process, from basic concepts to advanced patterns. Work through it progressively, or jump to the section you need.
 

Original file line number	Diff line number	Diff line change
`@@ -18,3 +18,4 @@ gemfiles/.bundle/`
`18`	`18`	`.tool-versions`
`19`	`19`
`20`	`20`	`/.claude/settings.local.json`
	`21`	`+/docs/plans/`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Getting Started with Solid::Process`
	`1`	`+# Solid::Process — Reference Guide`
`2`	`2`
`3`	`3`	`This guide teaches everything you need to know about Solid::Process, from basic concepts to advanced patterns. Work through it progressively, or jump to the section you need.`
`4`	`4`