News for hackers. Stuff that matters.
Re:Ask HN: I'm 23 and got a contract to write my first book,... by jamesbritt on Tuesday June 12, 2012 @02:39PM (#4102010)
I hope for it to be around ~500 pages

Too long.

It takes more work, but try to make it shorter.

The best value I've gotten from books is being able to avoid the slew of occasionally useful factoids and be told what stuff I should really care about.

The endless details I can find on the Web if I need them; the problem a tech author should solve is in helping the reader know what to care about and when.

Re:Ask HN: I'm 23 and got a contract to write my first book,... by dsawler on Tuesday June 12, 2012 @04:38PM (#4102694)
Seconded. Read "On Writing Well" -- write something, cut it in half, then cut that in half, and then once again cut that in half.
Re:Ask HN: I'm 23 and got a contract to write my first book,... by horsehead on Tuesday June 12, 2012 @06:21PM (#4103249)
When writing for publication, I enjoy pondering this quote: "If you say in the first chapter that there is a rifle hanging on the wall, in the second or third chapter it absolutely must go off. If it's not going to be fired, it shouldn't be hanging there." From S. Shchukin, Memoirs

That is to say, if you're going to write something, every word has to have potency. This gets at the cut in half, cut in half, cut in half advice.

In short, good writing is concise.

Re:Ask HN: I'm 23 and got a contract to write my first book,... by jamesbritt on Tuesday June 12, 2012 @09:49PM (#4103928)
At some techie user group someone had a copy of a pretty brief O'Reilly Rails book. I observed that the book price seemed the same as what O'Reilly charged for "full-length" books.

A friend then said he would be happy to pay even twice as much if the author could have made it half-again as short.

BTW, I could have sworn that quote was from Chekov. Either way, on the money.

Re:Ask HN: I'm 23 and got a contract to write my first book,... by StavrosK on Wednesday June 13, 2012 @09:40AM (#4105826)
Re:Ask HN: I'm 23 and got a contract to write my first book,... by horsehead on Wednesday June 13, 2012 @11:40AM (#4106475)
Yeah, I think it's a variation of the Chekov quote (I pulled it from the chekov's gun's wiki. That was the quote that stuck out to me the most from my classes in Uni).
Re:Ask HN: I'm 23 and got a contract to write my first book,... by Toph on Tuesday June 12, 2012 @03:56PM (#4102458)
Not sure if this is still true but I heard some publishers had a minimum pages requirement.
Re:Ask HN: I'm 23 and got a contract to write my first book,... by jamesbritt on Tuesday June 12, 2012 @11:50PM (#4104234)
I've written for Wrox (the first edition, the one that went bankrupt :))

When I was one of two co-authors of a book I don't recall being told to hit a specific page count, but there was a push for a certain degree of "thoroughness." This typically meant going into possibly tangential details to avoid sending someone off to another resource. (Though if the other resources was another Wrox book then allowances we made.)

For example, in a book about XML (Pro VB 6 & XML[0]) there was a need to go through the XML specification. A whole chapter. I ended up using this as an opportunity to explain the spec and build some helper libraries that would make interacting with a DOM easier later on, so not a total loss, but it had a feeling of busy-work to me.

That was sort of a best-case scenario; two authors splitting book. I also worked on assorted individual chapters for other books and there I had an incentive to bolster the word count because in some cases it affected the pay.

In my experience writing a single chapter meant either a flat amount or a per-word rate. Writing multiple chapters opened up the option of royalties instead. I took royalties on the VB book and did OK. Sadly this gave me a false impression of tech writing as a profession.

Many Wrox books were more a collection of padded chapters than coherent, well-planned, guides. OTOH I think many people plunked down $40-50 just to get specific chapters that would get them past some problem.

[0]: As the Velvet Underground sang, "Those were different times." :)