[plt-scheme] Documenting Scheme code

From: Grant Rettke (grettke at acm.org)
Date: Sun Sep 14 13:40:49 EDT 2008

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.

Posted on the users mailing list.