Skip to content

Link the API reference from the README and back again - #35

Merged
xcomart merged 1 commit into
masterfrom
docs/reference-links
Aug 3, 2026
Merged

Link the API reference from the README and back again#35
xcomart merged 1 commit into
masterfrom
docs/reference-links

Conversation

@xcomart

@xcomart xcomart commented Aug 3, 2026

Copy link
Copy Markdown
Owner

The reference was only reachable by typing /api/ onto the project page.

README → reference

The README is the landing page, so it now carries a badge in the existing row and a line right under it:

📖 API reference — every type and method, grouped by subject. This page is the guided tour; that one is the lookup.

Its ## API reference section now leads with the published URL instead of with instructions for building a local copy; the local build is still there, below.

Reference → back

The reference had no way back at all. Its main page now links to the project page, the repository and the samples.

It also told readers to use the Modules list, which has been called Topics since Doxygen 1.10 — so the one navigation hint it gave named a tab that does not exist. Fixed, and it now also mentions Data Structures and the search box.

Verification

  • doxygen 1.14.0: 0 warnings; the three back-links resolve in the generated index.html
  • Rebuild after the header edit: 0 compiler warnings, 15/15 ctest

Merging this triggers a Docs deployment, so the links go live with it.

🤖 Generated with Claude Code

The reference was only reachable by typing /api/ onto the project page.
The README - which is that page - now carries a badge and a line under it,
and its API reference section leads with the published URL rather than
with instructions for building a local copy.

The reference had no way back either. Its main page now links to the
project page, the repository and the samples, and points at "Topics"
rather than "Modules", which is what the tab has been called since
Doxygen 1.10.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@xcomart
xcomart merged commit 307f05e into master Aug 3, 2026
5 checks passed
@xcomart
xcomart deleted the docs/reference-links branch August 3, 2026 05:18
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