|
The page makes a definition list a term line --- ":: term" at the head
of the line, like every other block construct --- and a mid-line "::"
ordinary text. These pages were written in the trailing "term::"
form, which is AsciiDoc's and which the page replaced to remove a
footgun: prose reading "the a :: b thing" parsed as a definition.
The rendering does not change, except where it was wrong. The
trailing form folded an indented continuation into the term, so a
term's bold ran on over its own definition and, in a few pages, the
definition's first line came out after its second. Those read
correctly now.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015bWfjj7PP24iF5MqFHmdeC
|
|
The eight English section pages were missing, and with them the root
CHANGELOG.adoc and TODOs.adoc: what changed between two releases and
what is known to be left are not things a reader can work out from
the tree.
7README, 7CHANGELOG and 7TODOs are symlinks to the root documents, as
they are everywhere else. 0 links the rest, 7tutorial writes one page
start to finish, 7recipes has the tasks that come after that, and
7why says why the site is built this way.
3 is a reference page for a library, and a website has none; it says
so, and exists because a reader who knows where to look in one
repository should know where to look in all of them.
README.adoc gains the manpage title and NAME section the 7README
symlink needs to render, its prose unchanged.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KxLpaNQThKfMG3ecCJptP9
|
