[FM Discuss] Quick impressions following CiviCRM book sprint
adam hyde
adam at flossmanuals.net
Mon May 11 06:40:08 PDT 2009
hey,
Andy it would be great if you could add a section about your experiences
and thoughts to the manual on Book Sprints :
http://en.flossmanuals.net/bin/view/BookSprints
adam
On Mon, 2009-05-11 at 06:14 -0400, Andy Oram wrote:
> Pretty much agree with everything in Ed's mail. I did have one more thing to say about the Command-Line outline.
>
> I wanted it to be more than a high-level breakdown. I put a lot of detail into it for an important reason: I knew that any sections would depend on material from other sections and I wanted each author to feel confident that another section gave some background. For instance, the "for" statement refers to a variable, so the person writing it up has to know whether variables were described earlier or whether he has to take time to describe variables as well as the "for" statement. It turned out that we had some redundancy in the book, but it would have been worse without a detailed outline.
>
> Andy
> _______________________________________________
> Discuss mailing list
> Discuss at lists.flossmanuals.net
> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
--
Adam Hyde
Founder FLOSS Manuals
German mobile : + 49 15 2230 54563
Email : adam at flossmanuals.net
irc: irc.freenode.net #flossmanuals
"Free manuals for free software"
http://www.flossmanuals.net/about
More information about the Discuss
mailing list