Skip to content

docs: improve README navigation and contribution guidance#43

Open
Arbaaz123676 wants to merge 2 commits intoAOSSIE-Org:mainfrom
Arbaaz123676:docs/improve-readme-navigation
Open

docs: improve README navigation and contribution guidance#43
Arbaaz123676 wants to merge 2 commits intoAOSSIE-Org:mainfrom
Arbaaz123676:docs/improve-readme-navigation

Conversation

@Arbaaz123676
Copy link

@Arbaaz123676 Arbaaz123676 commented Feb 12, 2026

Summary

Improves README navigation and usability.

Changes

  • Added a Table of Contents
  • Converted absolute GitHub links to relative links
  • Improved readability and structure

Notes

Only documentation structure improvements.
Fixes #40.

Summary by CodeRabbit

  • Documentation
    • Added a Table of Contents to the README for improved navigation.
    • Replaced absolute links with relative/local links across multiple guidance pages (communication, social media, copyright, GSoC, ambassadors).
    • Added a "How to Contribute" section with basic contribution steps.
    • Updated the Document Index to reference local document paths.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 12, 2026

📝 Walkthrough

Walkthrough

The README.md was updated to add a Table of Contents, a "How to Contribute" section, and to replace several absolute GitHub links with relative/local links across Communication Guidelines, Social Media Guidelines, Copyright Information, Google Summer of Code Guidelines, Ambassadors Program, and the Documents Index.

Changes

Cohort / File(s) Summary
Documentation / README
README.md
Added Table of Contents and "How to Contribute" section; converted multiple absolute GitHub links to relative/local paths across communication, social media, copyright, GSoC, Ambassadors, and updated the Documents Index entries.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

Suggested reviewers

  • Zahnentferner

Poem

🐰
A tiny hop, a tidy tree of contents bright,
Links once far, now homeward — everything in sight.
New steps to help contributors find their way,
I nibble at docs and cheer for this clear day. 🥕✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main change: improving README navigation and contribution guidance through a Table of Contents, relative links, and a contribution section.
Linked Issues check ✅ Passed All coding objectives from issue #40 are met: Table of Contents added, absolute links converted to relative links, How to Contribute section added, and document naming consistency improved.
Out of Scope Changes check ✅ Passed All changes are directly aligned with the objectives in issue #40 and README documentation improvements; no out-of-scope changes detected.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

No actionable comments were generated in the recent review. 🎉


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@README.md`:
- Around line 10-15: The Table of Contents links currently point to header
fragments that may not match GitHub's anchor generation; update either the link
fragments or the corresponding headings so they match GitHub-style anchors
(lowercase, spaces → hyphens, remove punctuation and emojis). Specifically
verify and fix the TOC entries for "Who Should Use This Repository?", "Guidance
for Contributors", and "Required Reading (Before Contributing)" so their
fragments become e.g. `#who-should-use-this-repository`,
`#guidance-for-contributors`, and `#required-reading-before-contributing`, or
alternatively remove/adjust punctuation or emojis from the headings to make the
generated anchors match the existing links.

Comment on lines 10 to 15
## 📚 Table of Contents

- [Who Should Use This Repository?](#who-should-use-this-repository)
- [Guidance for Contributors](#guidance-for-contributors)
- [Required Reading (Before Contributing)](#required-reading-before-contributing)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Confirm TOC link fragments resolve correctly.

markdownlint flagged invalid fragments for the new TOC entries, which can happen when headings include emojis or punctuation. Please verify the generated anchor IDs match the links (GitHub vs. other renderers) and adjust if needed to avoid broken navigation.

🧰 Tools
🪛 markdownlint-cli2 (0.20.0)

[warning] 12-12: Link fragments should be valid

(MD051, link-fragments)


[warning] 13-13: Link fragments should be valid

(MD051, link-fragments)

🤖 Prompt for AI Agents
In `@README.md` around lines 10 - 15, The Table of Contents links currently point
to header fragments that may not match GitHub's anchor generation; update either
the link fragments or the corresponding headings so they match GitHub-style
anchors (lowercase, spaces → hyphens, remove punctuation and emojis).
Specifically verify and fix the TOC entries for "Who Should Use This
Repository?", "Guidance for Contributors", and "Required Reading (Before
Contributing)" so their fragments become e.g. `#who-should-use-this-repository`,
`#guidance-for-contributors`, and `#required-reading-before-contributing`, or
alternatively remove/adjust punctuation or emojis from the headings to make the
generated anchors match the existing links.

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.

[FEATURE]: Improve README navigation and contribution guidance

1 participant