Skip to content

docs(readme): surface live example report links#1065

Merged
dekobon merged 1 commit into
mainfrom
docs/readme-example-report-links
Jul 25, 2026
Merged

docs(readme): surface live example report links#1065
dekobon merged 1 commit into
mainfrom
docs/readme-example-report-links

Conversation

@dekobon

@dekobon dekobon commented Jul 25, 2026

Copy link
Copy Markdown
Owner

What

Restores prominent links to the live example reports in README.md
and README.ja.md, adding a labelled link pair directly after the
feature bullets:

Why

Those URLs were not lost, but the README rewrite in ec8184c2 folded
the top-level ## Live example reports section into
## Quality gates and reports in CI, pushing them roughly a hundred
lines down the page. They are the fastest way for a new reader to see
what the analysis actually looks like, so they belong above the fold.

The CI section keeps its copy of the URLs — there they document what
.github/workflows/pages.yml publishes, which is a different reader's
question.

README.ja.md gets the same pair, marked 「(英語)」: the reports are
published at /reports/, not under /ja/, so they are English-only.

Validation

  • rumdl check README.md README.ja.md — clean.
  • Both report URLs return HTTP 200.
  • Docs-only; no code, public API, or metric behaviour touched, so no
    CHANGELOG.md entry (matching how ec8184c2 was handled).

The self-scan reports are the fastest way for a new reader to see
what bca actually produces, but the README rewrite in ec8184c folded
the top-level "Live example reports" section into the CI section,
leaving the links roughly a hundred lines down the page.

Add a labelled link pair (HTML hotspot report, Markdown report)
directly after the feature bullets in both READMEs, above the fold.
The CI section keeps its copy of the URLs, where they document what
the pages workflow publishes. The Japanese README marks the pair as
English-only, since the reports are published at /reports/ rather
than under /ja/.
@dekobon
dekobon merged commit 6d1e2d5 into main Jul 25, 2026
34 checks passed
@dekobon
dekobon deleted the docs/readme-example-report-links branch July 25, 2026 19:57
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