[plt-scheme] documentation guidelines & tools

From: Grant Rettke (grettke at acm.org)
Date: Fri Jun 8 11:15:24 EDT 2007

Schemedoc works for code that does not live in modules and runs on v370:

http://www.cs.aau.dk/~normark/schemedoc/

On 6/7/07, YC <yinso.chen at gmail.com> wrote:
> Hi all -
>
> I have a few questions regarding creating documentations for libraries...
> thanks for any input ;)
>
> 1) Is there a standard guideline on how to do documentations/comments?
>
> 2) Most libs have doc.txt - is there a standard template for doc.txt and
> explanations for its format?
>
> 3) Any Scheme philosophy on inline documentations in the code (i.e. for or
> against) - It seems that Scheme doesn't have docstrings, does this mean it's
> not actively encouraged as a style?
>
> 4) Any tools for generating doc.txt from inline documentations?
>
> Thanks,
> yinso
>
>
> _________________________________________________
>   For list-related administrative tasks:
>   http://list.cs.brown.edu/mailman/listinfo/plt-scheme
>
>


Posted on the users mailing list.