[plt-scheme] Documenting Scheme code

From: Robby Findler (robby at cs.uchicago.edu)
Date: Sun Sep 14 17:33:13 EDT 2008

Also inside the code. See provide/doc.

Robby

On Sun, Sep 14, 2008 at 12:40 PM, Grant Rettke <grettke at acm.org> wrote:
> On Sun, Sep 14, 2008 at 12:00 PM, Marek Kubica <marek at xivilization.net> wrote:
>> Or am I just thinking too much about it and it would be best to write a
>> documentation comment using ; before the function definition?
>
> Marek what you are touching upon is a philosophical decision everyone
> makes regarding how they document the API for their code:
>
> In the code or outside of it.
>
> There are pros and cons to each approach.
>
> PLT does it in Scribble files outside of the code.
> _________________________________________________
>  For list-related administrative tasks:
>  http://list.cs.brown.edu/mailman/listinfo/plt-scheme
>
>


Posted on the users mailing list.