[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: manual examples - self contained or not?
From: |
Noah Lavine |
Subject: |
Re: manual examples - self contained or not? |
Date: |
Sun, 19 Feb 2012 16:02:07 -0500 |
Hello,
> My vote would be for self-contained: it can be copied directly into a
> file or REPL and executed, and IMO reduces confusion. I already try to
> do this when posting any examples on paste.lisp.org or in a gist.
When you say "self-contained", do you mean that if the example uses a
procedure from a module, it should have a (use-modules ...) statement?
If so, that sounds good to me.
If you mean that most examples should never use procedures that are in
modules, that seems a little restrictive.
Noah