[cl-faq] YAMLL (repost)

[Jean-François Brouillet]

> 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 Peter Seibel has editorial control, we should prevent
him from making the PCL entries :-)
--
JFB