[cl-faq] cl-faq Digest, Vol 2, Issue 3

[Peter Seibel]

On Jan 6, 2006, at 6:40 AM, Jean-François Brouillet wrote:

>> 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))
>>
>>      ...)
>
> At a minimum, I'd have a :summary keyword added.
>
> If we end-up with hundred's of links that just point elsewhere,
> that's only half as useful as if those links are accompanied
> by a short summary paragraph.
>
> Consider scrolling the resulting list for ages with only a name
> and a bunch of keywords for each item:
>
> + Practical Common Lisp  - documentation, book, printed, online,
> beginner, intermediate
>
> How do I know if am interested?
>
> On the other hand, if the item were to appear as
>
> + Practical Common Lisp  - documentation, book, printed, online,
> beginner, intermediate
>
>    A Hands on introduction to Lisp that takes you from advanced Java
> user
>    to competent Lisp programmer, with case studies illustrating spam
> filtering,
>    creating an MP3 database and browser while parsing MP3 embedded
> tags, or
>    dynamic HTML creation.
>
>    Once Practical Common Lisp has set you comfortable with the main
> ideas
>    and philosophies behind Common Lisp, you will want to further your
>    understanding by reading Peter Norvig's PAIP and Paul Graham's On
> Lisp.
>
> Yes, that is a lot of editorial work, but that's the price to pay if
> we don't want to get YAMLL (Yet Another Mindless List of Links.)
>
> BTW: even though Pieter Siebel has editorial control, we should  
> prevent
> him from making the PCL entries :-)

Just to be clear, this discussion, although taking place on the cl- 
faq list had veered off to discuss the common-lisp directory project  
which is Marc and Paolo's baby--I'm just editing (or, rather at the  
moment not finding time to edit) the FAQ.

-Peter

-- 
Peter Seibel           * peter at gigamonkeys.com
Gigamonkeys Consulting * http://www.gigamonkeys.com/
Practical Common Lisp  * http://www.gigamonkeys.com/book/