apsis-book/src/docs
dev a360238a95 Write the comments in both languages, part one
The comments in this service were written in English alone, while the
library it belongs to writes every comment in English and then in Chinese.
The smaller modules are done here: the library root, the bilingual text,
the shared state, the embedded content and assets, the three HTTP modules,
the entry point, the test seams, the tool labels, and the interface
catalogue reader.

A doc comment carries the English text, an empty doc line, and then the
Chinese. An inline comment carries the English line and then the Chinese.
Both are how the library already writes them.

The empty doc line matters and was wrong at first. A blank line between
the two halves is not the same thing: it detaches the second half from the
item it documents, and the compiler says so. A hundred of them were
rewritten as empty doc lines.
2026-10-02 13:17:41 +08:00
..
api.rs Write the comments in both languages, part one 2026-10-02 13:17:41 +08:00
content.rs Write the comments in both languages, part one 2026-10-02 13:17:41 +08:00
document.rs Move every test out of src, as apsis-rs does 2026-10-02 01:56:21 +08:00
markdown.rs Write the notation in the text, not in a code span 2026-10-02 12:45:56 +08:00
mathml.rs Write the notation in the text, not in a code span 2026-10-02 12:45:56 +08:00
mod.rs Write the comments in both languages, part one 2026-10-02 13:17:41 +08:00