chicken-users
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Chicken-users] FrOSCon 2011 Talks


From: John Gabriele
Subject: Re: [Chicken-users] FrOSCon 2011 Talks
Date: Tue, 23 Aug 2011 01:27:48 -0400

On Sun, Aug 21, 2011 at 6:25 AM, Christian Kellermann
<address@hidden> wrote:
> Hi Chicken-fans,
>
> {...}
>
> A somewhat badly formatted handout can be found at
> http://pestilenz.org/~ckeen/chickenista-guide.pdf
>
> Newcomers, please have a look and if you happen to have some spare
> time, get me some feedback on what can be improved. I would like to
> reuse this on the chicken wiki as an introduction.
>

Hi again, Christian,

Regarding the chickenista guide pdf, some minor issues I noticed:

  * on page 2, after wget line you also need `tar xzf chicken-4.7.0.tar.gz`

  * on page 3, chicken-status shows currently *installed* eggs,
correct? Wouldn't currently available eggs be ones that you could
install via chicken-install if you wanted to?

  * page 5: s/ships with extension/ships with extensions/

  * bullet list starting at the bottom of page 5 could use colons
between unit names and descriptions

  * page 6: s/the are/they are/

  * page 7: s/deviatoins/deviations/

  * page 8: This sentence needs rewording: "It is easier to use the
API search chickadee for this."

  * page 9: "The home of bugs: Chicken's bug tracker" is rendered as
section 4.5.5. Since section 4.5 is about documentation, was the bug
tracker section supposed to be one level up (that is, section 4.6)?
Same with the section after it ("Getting help from humans").

  * page 11: s/a mp3/an mp3/

Finally, I notice some inconsistent capitalization of "Chicken"
(sometimes "CHICKEN" and "chicken") and "Scheme" (sometimes "scheme").
Also "lisp" on page 10.

As far as more substantial feedback on the content itself, I would've
liked longer descriptions for most of the bullet points in section
4.4, as well as more explanation about what exactly a "unit" is and
what the differences are between units, extensions, eggs, and modules.

Thanks again for the docs!

---John



reply via email to

[Prev in Thread] Current Thread [Next in Thread]