Skip to content

docs: fix README anchor links - #628

Open
dfm88 wants to merge 1 commit into
feyninc:mainfrom
dfm88:docs/fix-readme-anchor-links
Open

docs: fix README anchor links#628
dfm88 wants to merge 1 commit into
feyninc:mainfrom
dfm88:docs/fix-readme-anchor-links

Conversation

@dfm88

@dfm88 dfm88 commented Jul 7, 2026

Copy link
Copy Markdown

Hi! Thanks for your work maintaining this library.

This is just a small README update to the internal links in the top navigation that currently are not redirecting to the correct sections.

Summary by CodeRabbit

  • Documentation
    • Improved README internal navigation by switching to stable, plain-text section links (no emoji-based anchors) so jumps are consistent.
    • Updated intro “integrations” and related mascot block links to point to the new fragment targets for accurate in-page navigation.

Copilot AI review requested due to automatic review settings July 7, 2026 09:27
@coderabbitai

coderabbitai Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 722fb073-250c-417d-86be-0d700be90d22

📥 Commits

Reviewing files that changed from the base of the PR and between 4d40105 and 8de18c5.

📒 Files selected for processing (1)
  • README.md

📝 Walkthrough

Walkthrough

The PR updates README.md navigation and mascot-block links to use revised non-emoji fragment identifiers.

Changes

README Anchor Update

Layer / File(s) Summary
Navigation and inline links
README.md
Top navigation links and the mascot block’s integrations and “Moto Moto” links now target the revised section fragments.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Possibly related PRs

Suggested reviewers: chonk-lain

Poem

Hop, hop, the links now point just right,
No emoji anchors in sight.
Through README trails I cheerfully roam,
Every little fragment leads home. 🐇

🚥 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 documentation-only change to fix README anchor links.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Code Review

This pull request simplifies the anchor links in the README.md table of contents by removing emojis from the link targets and adding corresponding HTML anchor tags before each heading. The reviewer pointed out that GitHub Flavored Markdown (GFM) automatically generates these anchor IDs by converting heading text to lowercase, replacing spaces with hyphens, and stripping emojis/special characters. Therefore, the added HTML anchor tags are redundant and can be safely removed to keep the Markdown clean.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread README.md Outdated
Comment on lines +41 to +42
<a id="installation"></a>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

GitHub Flavored Markdown (GFM) automatically generates anchor IDs for headings by converting the text to lowercase, replacing spaces with hyphens, and stripping emojis/special characters. Therefore, headings like ## 📦 Installation automatically get the ID installation. The added <a id="installation"></a> tag is redundant and can be safely removed to keep the Markdown clean.

Comment thread README.md Outdated
Comment on lines +77 to +78
<a id="usage"></a>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

GitHub Flavored Markdown (GFM) automatically generates anchor IDs for headings by converting the text to lowercase, replacing spaces with hyphens, and stripping emojis/special characters. Therefore, headings like ## 🚀 Usage automatically get the ID usage. The added <a id="usage"></a> tag is redundant and can be safely removed to keep the Markdown clean.

Comment thread README.md Outdated
Comment on lines +180 to +181
<a id="chunkers"></a>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

GitHub Flavored Markdown (GFM) automatically generates anchor IDs for headings by converting the text to lowercase, replacing spaces with hyphens, and stripping emojis/special characters. Therefore, headings like ## ✂️ Chunkers automatically get the ID chunkers. The added <a id="chunkers"></a> tag is redundant and can be safely removed to keep the Markdown clean.

Comment thread README.md Outdated
Comment on lines +202 to +203
<a id="integrations"></a>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

GitHub Flavored Markdown (GFM) automatically generates anchor IDs for headings by converting the text to lowercase, replacing spaces with hyphens, and stripping emojis/special characters. Therefore, headings like ## 🔌 Integrations automatically get the ID integrations. The added <a id="integrations"></a> tag is redundant and can be safely removed to keep the Markdown clean.

Comment thread README.md Outdated
Comment on lines +377 to +378
<a id="benchmarks"></a>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

GitHub Flavored Markdown (GFM) automatically generates anchor IDs for headings by converting the text to lowercase, replacing spaces with hyphens, and stripping emojis/special characters. Therefore, headings like ## 📊 Benchmarks automatically get the ID benchmarks. The added <a id="benchmarks"></a> tag is redundant and can be safely removed to keep the Markdown clean.

Comment thread README.md Outdated
Comment on lines +405 to +406
<a id="acknowledgements"></a>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

GitHub Flavored Markdown (GFM) automatically generates anchor IDs for headings by converting the text to lowercase, replacing spaces with hyphens, and stripping emojis/special characters. Therefore, headings like ## 🙏 Acknowledgements automatically get the ID acknowledgements. The added <a id="acknowledgements"></a> tag is redundant and can be safely removed to keep the Markdown clean.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

This PR updates README internal navigation links so the top “Installation / Usage / Chunkers / Integrations / Benchmarks” links correctly jump to their corresponding sections.

Changes:

  • Updated top navigation links to use simplified fragments (e.g., #installation, #usage).
  • Added explicit HTML anchor tags (<a id="..."></a>) above key section headings to match those fragments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
Comment on lines +41 to +42
<a id="installation"></a>

Comment thread README.md Outdated
Comment on lines +77 to +78
<a id="usage"></a>

Comment thread README.md Outdated
Comment on lines +180 to +181
<a id="chunkers"></a>

Comment thread README.md Outdated
Comment on lines +202 to +203
<a id="integrations"></a>

Comment thread README.md Outdated
Comment on lines +377 to +378
<a id="benchmarks"></a>

Comment thread README.md Outdated
Comment on lines +405 to +406
<a id="acknowledgements"></a>

@dfm88

dfm88 commented Jul 7, 2026

Copy link
Copy Markdown
Author

I just checked that suggestions from gemini and copilot seems not to work, so my solution seems to stands right now

Comment thread README.md Outdated
Comment on lines +41 to +42
<a id="installation"></a>

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

instead of adding new <a>, why not get the original links from the readme, after you click each section they will appear in the url in the page above, example for installation it should be : #-installation

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Uh yeah makes sense, just pushed the fix.

One note about the ## ✂️ Chunkers link: that particular emoji doesn't let the plain #-chunkers work (it leaves an invisible character in the generated slug), so Claude resolved it as #%EF%B8%8F-chunkers. Tested and it works now, thanks!

@dfm88
dfm88 force-pushed the docs/fix-readme-anchor-links branch from 4d40105 to 8de18c5 Compare July 16, 2026 10:27
@coderabbitai
coderabbitai Bot requested a review from chonk-lain July 16, 2026 10:28
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.

3 participants