On Fri, 2006-06-09 at 15:44 -0400, root wrote:
> Would it be reasonable to try to generate "chapters" for the various
> contributions by missing categories? E.g. (following Steele 2nd Ed.)
> That way we're working "top down" to try to categorize the work and
> possibly focus the effort.

I like your idea of focusing the effort this way. My time constraints
combined with my inexperience with Lisp dictate that I can be a
productive contributor if someone else writes a slew of docs for
unwritten functions, along the lines Chris Dean quoted:

> As an examplar of the documenation level I'm aiming for see:
>   http://www.weitz.de/cl-ppcre/#all-matches
> 
>     all-matches regex target-string &key start end => list
> 
>     Returns a list containing the start and end positions of all
>     matches of regex against target-string, i.e. if there are N
>     matches the list contains (* 2 N) elements. If regex matches an
>     empty string the scan is continued one position behind this match.
> 
>         Examples:
> 
>         * (cl-ppcre:all-matches "a" "foo bar baz")
>         (5 6 9 10)
> 
>         * (cl-ppcre:all-matches "\\w*" "foo bar baz")
>         (0 3 3 3 4 7 7 7 8 11 11 11)
> 
Then I could get in, quickly look at the different functions, pick
something appropriate to my skill level and send it in, which is about
all I can do at this stage.

Because of this, I'd rank documentation at or near the top of priorities
for this project, since documentation which precedes code would make it
much easier for me to contribute.

Steve

_______________________________________________
Gardeners mailing list
[email protected]
http://www.lispniks.com/mailman/listinfo/gardeners

Reply via email to