Skip to content

Improve documentation links, breadcrumbs, and README structure - #21

Merged
serradura merged 9 commits into
mainfrom
chore/docs
Jan 29, 2026
Merged

serradura merged 9 commits into
mainfrom
chore/docs

Conversation

@serradura

@serradura serradura commented Jan 29, 2026

Copy link
Copy Markdown
Member

Summary

  • Fix redundant relative paths in REFERENCE.md breadcrumb links (../docs/ → relative)
  • Fix Previous link path in 010_KEY_CONCEPTS.md (../../../ to reach root)
  • Update breadcrumb anchors to point to Table of Contents
  • Reorder README sections: move Getting Started after Basic Structure
  • Remove duplicate Reference Guide link and AI Agents callout
  • Restructure .claude/docs/documentation.md with dedicated Breadcrumb Navigation section

Test plan

  • Verify all breadcrumb links resolve correctly on GitHub
  • Confirm README section ordering reads well top-to-bottom

Reorder Further Reading section in README and update Previous
links in 010_KEY_CONCEPTS to point to the Documentation heading.
Use ../../README.md instead of ../README.md to correctly resolve
from docs/overview/ to the root README.
Place Installation and Basic Structure before Getting Started so
readers see what the gem looks like before being directed to guides.
Extract breadcrumb navigation into its own section, add REFERENCE.md
nav docs, and fix overview Previous link path to match actual targets.
@serradura serradura changed the title Fix redundant relative path in REFERENCE.md breadcrumbs Improve documentation links, breadcrumbs, and README structure Jan 29, 2026
@serradura serradura self-assigned this Jan 29, 2026
@serradura
serradura merged commit ccf0097 into main Jan 29, 2026
9 checks passed
@serradura
serradura deleted the chore/docs branch January 29, 2026 17:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant