[Asdf-devel] Chipping away at the manual
fahree at gmail.com
Sun Apr 6 15:01:29 UTC 2014
On Sat, Apr 5, 2014 at 11:31 PM, Robert P. Goldman <rpgoldman at sift.info> wrote:
> If you are interested in the current status, see the 'docs' topic branch.
> You will see there some work products, particularly a marked up copy of
> the old manual, with my thoughts about what needs to be done, and a
> ledger of exported symbols, which should be documented in the manual.
> Comments and suggestions welcomed. Patches also welcomed, but for that
> perhaps it's best you contact me. I'd be happy to cede parts of the
> manual to others.
Thanks a lot for this important documentation work.
If you want me to document some functions you're not sure you
understand, please tell me which.
Should it be a release blocker, though? Lack of documentation for
exported functions is not a regression.
PS: I'm slightly disappointed you felt more comfortable using perl
rather than CL for those scripts. :-)
PPS: my ASDF3 paper was accepted at ELS 2014!
I already improved the paper much from the feedback, but more feedback
still welcome, especially for the extended version of the paper. Said
extended version can also provide background information or copy/paste
material for the manual; conversely, parts of the manual could be
removed and replaced with references to the paper.
—♯ƒ • François-René ÐVB Rideau •Reflection&Cybernethics• http://fare.tunes.org
An apple every eight hours will keep three doctors away.
More information about the asdf-devel