[cl-faq] Is a wiki format suitable for developing a faq?

[Michael J Forster]

On Thu, Jan 05, 2006 at 04:38:46PM +0100, Marc Battyani wrote:
> "Michael J Forster" <mjf at hypatia.sharedlogic.ca> wrote:
> > On Thu, Jan 05, 2006 at 03:58:20PM +0100, Paolo Amoroso wrote:
> > >
> > > You might consider adding them to the brand new Common Lisp Directory:
> > >
> > >   http://www.cl-user.net
> 
> > Great.  I've been wondering about that since the first posts regarding
> > Marc's directory.  However, I've haven't had time to follow the
> > ensuing discussion, nor have I checked with Peter since he first
> > asked me to submit the links as a big sexpr.  What is the consensus
> > at this point?  Peter?
> >
> > If CLD it is, can I ask if there's a mass submission upload-sexpr-here
> > page? :-)
> 
> Send me the huge s-expr and I will type a cool loop in the CLD listener to create all the
> entries.
> Then we will just have to manually add the tags and the links like related items etc.
> But at least it could be a good start and avoid duplicating the effort anyway.
> 
> Marc

Thanks Marc!  Will do.  I have about 100 remaining links to format.
While I'm at it, would it be helpful to include some of the CLD
tags.  I have been attaching a list keywords to each link as follows:


'((:url "http://www.lispniks.com/cl-gardeners/"
   :description "CL Gardeners project. Group devoted to improving
   the Common Lisp Landscape."
   :keywords (group))

  (:url "http://www.gigamonkeys.com/book/"
   :description "Practical Common Lisp, online version of the
   introduction to Common Lisp by Peter Seibel."
   :keywords (documentation book printed online beginner intermediate))

     ...)

I've haven't been completely consistent with the keywords, but it
was my intention to extract a list of the ones I have used, clean
them up, and then do a mass substitute against the sexpr accordingly.
I could just as well use the appropriate CLD tags instead.

On the other hand, if we leave out the tags, would the CLD interface
allow us to leverage the efforts of others in assigning tags to
existing links?  Sorry, I really do need to have a good look at the
directory (sign up for an account, even), but that will have to
wait until the weekend as well.


-Mike

--
Michael J. Forster
Shared Logic Inc.