Also, test texinfo generation on github.
960 B
-
How/when to load/include docs of contribs?
Currently,
sb-manualloads all contribs to be able to query the definition docstrings. Each contrib directory has amanual.lispfile, which is part of thesb-manualcontrib.On the positive side, this does not load extra stuff until the user
requiressb-manual. However, then it loads all contribs.It shouldn't be difficult to show documtation only for actually loaded contribs.
-
How to deal with repetitive package names?
For example,
sb-alienis:used bysb-manualso that the section docstrings need not fully qualify withsb-alien:a thousand times. In the generated Texinfo, this can be a tad confusing. In output formats with links (e.g. HTML from PAX), this is clearly preferable.Nicknames, maybe?
-
Improve section names
They are a soft interface: exported from
sb-manualand visible to the user via HTML anchors.