[plt-dev] guide vs reference

From: Sam TH (samth at ccs.neu.edu)
Date: Mon Dec 14 14:28:23 EST 2009

On Mon, Dec 14, 2009 at 2:18 PM, Jon Rafkind <rafkind at cs.utah.edu> wrote:
> What is the reason that the guide is separate from the reference? They seem
> close enough to me to warrant merging them.

I think having both is very important.  Compare:

http://docs.plt-scheme.org/reference/stx-patterns.html#%28form._%28%28lib._scheme/private/stxcase-scheme..ss%29._syntax-rules%29%29

which is usually what I would want if I was looking something up while
programming, and

http://docs.plt-scheme.org/guide/pattern-macros.html#%28part._define-syntax_and_syntax-rules%29

which is what I point people to when the need to learn about writing
macros with `syntax-rules'.

I don't think either would be served by combining them.
-- 
sam th
samth at ccs.neu.edu


Posted on the dev mailing list.