News for hackers. Stuff that matters.
Re:Ruby Best Practices (full book available for download) by bgraves on Thursday March 18, 2010 @02:42PM (#1202105)
Wow! I'm glad I came back into this thread -- these are all such great tips. Especially the advisory group (item 2)
Re:Ruby Best Practices (full book available for download) by jamesbritt on Saturday March 20, 2010 @03:00AM (#1206125)
The point about leaving stuff out is very important.

When I was co-authoring Pro VB 6 & XML I was always coming across topics that could be books in themselves. Database details, designing COM objects, stuff like that.

I hated the idea that a chapter would leave the reader n limbo over some key aspect, but also didn't want to book to be even larger than it was likely to be, and explaining stuff can get hard.

So there were lots of places where I simply had to point and refer the reader to some other book or resource. There's not much you can do about that other than try to be mindful of when it is the right choice.

Re:Ruby Best Practices (full book available for download) by sandal on Saturday March 20, 2010 @10:06AM (#1206399)
I decided ahead of time that my book would be exactly 300 pages. I submitted an exactly 300 page manuscript, but I think my copyeditor shaved two pages of extraneous words :-/

Anyway, point being, I was pretty obsessive about not letting the book balloon. It forced me to put the knife to a lot of good content that wasn't quite great.

Re:Ruby Best Practices (full book available for download) by jamesbritt on Saturday March 20, 2010 @01:32PM (#1206641)
Setting a max page count is a good plan. I'm sure that had never occurred to anyone at Wrox, where books were routinely at the 1K+ pages mark.