Skip to content

Improve documentation links, breadcrumbs, and README structure#21

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

Improve documentation links, breadcrumbs, and README structure#21
serradura merged 9 commits intomainfrom
chore/docs

Conversation

@serradura
Copy link
Copy Markdown
Member

@serradura serradura commented Jan 29, 2026

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