Render the API reference as Hugo content instead of embedding javadoc HTML - #5743

Merged

shai-almog merged 24 commits into

masterfrom

javadoc-hugo-doclet

Sep 9, 2026

Commits on Sep 9, 2026

Render the API reference as Hugo content instead of embedding javadoc HTML

shai-almog
and
claude
committed
bac8a4b
Fix both CI failures and the five review findings on the API pages

shai-almog
and
claude
committed
c93b8f9
See also: read a backticked reference, and render a markdown one as markdown

shai-almog
and
claude
committed
5871b49
Keep the HTML left in markdown comments instead of silently dropping it

shai-almog
and
claude
committed
af3d808
Make the API validation step quote-agnostic, and the parity gate non-vacuous

shai-almog
and
claude
committed
85cf883
Second review round: six findings, all real, plus the residue one of them exposed

shai-almog
and
claude
committed
00d4272
Gate internal API links, and fix the two kinds of dead link it found

shai-almog
and
claude
committed
bb0b672
Third review round: five findings, all real

shai-almog
and
claude
committed
19416f7
Fourth review round: resolve names in context, and spell non-finite defaults

shai-almog
and
claude
committed
c11a4ff
Fifth review round: four findings, all real

shai-almog
and
claude
committed
3cf6e72
Sixth review round: four findings, all real

shai-almog
and
claude
committed
3f08b45
Seventh review round: three findings, all real

shai-almog
and
claude
committed
2915c1d
Eighth review round: a latent crash, a hole in my own gate, and three defects

shai-almog
and
claude
committed
3dccbf3
Ninth review round: four findings, all real, and 22 safety notes recovered

shai-almog
and
claude
committed
3afb1c9
Tenth review round: four findings, and a third gate pass for the blind spot

shai-almog
and
claude
committed
d766024
Eleventh review round: search results showed their own markdown source

shai-almog
and
claude
committed
c755cd8
Publish API pages at URLs Cloudflare Pages can actually serve

shai-almog
and
claude
committed
2ae7dd8
Twelfth review round: six findings, one of them 1189 lost links

shai-almog
and
claude
committed
3bcef04
Thirteenth review round: three findings, one a regression of my own

shai-almog
and
claude
committed
06488b1
Render enum constants as constants, not as fields

shai-almog
and
claude
committed
acc5452
Split trailing sections out of every block tag, and keep interfaces off Object

shai-almog
and
claude
committed
73842e6
Annotation types are interfaces too, in every traversal

shai-almog
and
claude
committed
14a88cd
Stop promoting abstract members a published class already implements, and stop

shai-almog
and
claude
committed
a142351
Resolve unqualified references the way the language does, and stop treating code spans as markup

shai-almog
and
claude
committed
33d5154

Navigation Menu

Uh oh!

Render the API reference as Hugo content instead of embedding javadoc HTML - #5743

Render the API reference as Hugo content instead of embedding javadoc HTML#5743
shai-almog merged 24 commits into
masterfrom
javadoc-hugo-doclet

Commits on Sep 9, 2026

Render the API reference as Hugo content instead of embedding javadoc HTML

Fix both CI failures and the five review findings on the API pages

See also: read a backticked reference, and render a markdown one as markdown

Keep the HTML left in markdown comments instead of silently dropping it

Make the API validation step quote-agnostic, and the parity gate non-vacuous

Second review round: six findings, all real, plus the residue one of them exposed

Gate internal API links, and fix the two kinds of dead link it found

Third review round: five findings, all real

Fourth review round: resolve names in context, and spell non-finite defaults

Fifth review round: four findings, all real

Sixth review round: four findings, all real

Seventh review round: three findings, all real

Eighth review round: a latent crash, a hole in my own gate, and three defects

Ninth review round: four findings, all real, and 22 safety notes recovered

Tenth review round: four findings, and a third gate pass for the blind spot

Eleventh review round: search results showed their own markdown source

Publish API pages at URLs Cloudflare Pages can actually serve

Twelfth review round: six findings, one of them 1189 lost links

Thirteenth review round: three findings, one a regression of my own

Render enum constants as constants, not as fields

Split trailing sections out of every block tag, and keep interfaces off Object

Annotation types are interfaces too, in every traversal

Stop promoting abstract members a published class already implements, and stop

Resolve unqualified references the way the language does, and stop treating code spans as markup