March 4th, 2007

This week is the last week for editing on the new book, and the editors are just now finishing up. I wanted to thank the folks who gifted me with their time and effort; providing reviews, technical and other editing, and suggestions. I had a good group of people and the book is going to be a superior product based on their effort:

Roger Johansson of 456 Berea Street was spot on with CSS, issues related to accessibility, as well as general markup and page design. He also managed to catch numerous typos.

Elaine Nelson of Emergency weblog provided not only tech editing, but also did an excellent job of content editing.

Roy Owens — not the singer. Roy also helped me on Learning JavaScript. Some people are gluttons for punishment.

Anne Zelenka of Anne 2.0 provided a higher level analyst view, as well as spotting gotchas, areas of confusion, and points of information that should have been included, but weren't.

Jesse Skinner, from The Future of the Web who is an expert on unobtrusive Ajax, and is currently working on a Short Cut for O'Reilly on unobtrusive Ajax. Jesse specifically focused on the tech, and his extensive knowledge of the Ajax world was extremely valuable.

Anthony Holdener, who is writing O'Reilly's Definitive Guide to Ajax, contributed edits for the first three chapters until he had to return to his book. I appreciate the extra effort.

Kathy Sierra, of Creating Passionate Users did a first chapter review and provided some excellent insight into refocusing the first chapter and making important points more discernible.

My main editor, Simon St. Laurent, of course. This is my third book with Simon. Did I mention, gluttons for punishment?

It is a lot of work to review a tech book. You're not just reading the book, you're:

  • looking for typos
  • looking for missed opportunities
  • watching out for uses of technology that could be improved
  • watching out for uses of technology that really need to be improved
  • helping to discover areas where the author has made a mistake (all authors make mistakes)
  • helping to sooth and tame wild, clumsy, and agitated phrases
  • doing all of this within the constraints of an awkward book template, under deadline, with an overly tired author

The editing team for a book is the author's only support in what is a difficult task. They form the parachute when we're free falling; the additional sets of eyes when our own are tired and strained. Of course, the editing team can also only do so much: in the end, whatever is missed is ultimately the responsibility of the author.

Thank you. Thank you all most sincerely, from the bottom of my book writing heart.

Comments
1
Bill - 11:28 am 3/4/2007

That's a nice set of editors you got to work with. Hopefully the people working on the rest of the process are just as good, so I can buy the darn thing soon!

2
Shelley - 12:19 pm 3/4/2007

They are. It will be nice to see this one on the street.

3

[…] Definitive Guide to Ajax Anthony Holdener, who is writing O'Reilly's Definitive Guide to Ajax, contributed edits for the first three chapters until he had to return to his book. I appreciate the extra effort.Burningbird: With Appreciation […]

4
Jim - 12:40 pm 3/4/2007

All white people? Where's the diversity? ;)

5
Shelley - 1:13 pm 3/4/2007

Actually, I had asked a black developer who I respect greatly and he'd originally said yes, but ended up not being able to participate. I was disappointed, but understanding as it is a time consuming job.

I didn't ask him because he was black, though. I did so because he would have contributed a wonderfully unique perspective to the work, leading to a more diverse product.

Additionally, I've not physically met any of the folks I've mentioned directly, though I have seen photos of some of them. For all we know, I may have a black editor in this mix.

6

Roger Johansson of 456 Barea Street was spot on with CSS …

Oops! Or did you leave one last typo for the man from "Berea Street"?

Well done with the latest book Shelley. Your cobbers from Down Under hope it sells well worldwide.

7
Shelley - 3:56 pm 3/4/2007

See? I need my editors.

Thanks Allan!

8

It's too late to send in comments? Going on vacation really messed with my time. I'm about halfway done and was going to send mine in tomorrow. I can still send them in even if there isn't any chance they'll get acted on.

PS: I really wanted to see the first chapter refocused so I'm glad someone mentioned that since it looks like my comments won't be actionable.

9
Shelley - 4:58 pm 3/4/2007

Dare, I figured you were booked and didn't want to hold your feet to the fire. If you have comments, I'd love to read what you have, and thank you. I do have to be finished by week end, but I should still be able to 'act' on your comments.

10
Anne Z. - 5:25 pm 3/5/2007

Shelley - it was my pleasure to review the book. Thank you for suggesting me. I'm only sorry I couldn't dig more deeply into it.

11
Shelley - 10:06 pm 3/5/2007

You provided a great deal of help, Anne, and my thanks.

Or should I say, Anne 2.1 ;-)

Thanks to all those who have contributed to the discussion. Comments are now closed, but you can contact the author of the post directly.