Live data from Hacker News

Writing a technical book: from idea to print

sararobinson.dev

21–30 of 36 posts

Re: Writing a technical book: from idea to print

#21

Earlier quoted context omitted.

Did you create the illustrations yourself or the publisher managed to do them for you?

I did them myself. Back to the "social proof" thing, the book is the outgrowth of a fairly successful webcomic I've done off and on for a few years [0], which was attractive to the publisher. [0] https://faasandfurious.com

Oh nice!

Re: Writing a technical book: from idea to print

#22
This is a great post mirroring much of my OReilly process. Writing a book can be a wonderful process.

After authoring over a dozen books, I'm making an end-to-end authoring course[0] for those interested in self-publishing. I interview a dozen authoring folks that are known around these parts to get their wisdom as well.

0 - https://mattharrison.podia.com/effective-authoring

Re: Writing a technical book: from idea to print

#23

Having recently released a "technical" book with a large traditional publisher (Wiley) [0], here are a few of my learnings: - Expect nothing from the publisher in terms of marketing support. In fact, a good nonfiction book proposal is going to spend most of its length explaining to the publisher how you will sell the book for them through your connections and credibility - not the other way around. It's all on you. -…

That's really cool. I would think that for your "non-traditional" book, having a publisher help you would be useful. I haven't seen many "highly graphic" self-published books.

People have various reasons for publishing. Will a publisher get you in front of the most eyes? Maybe, I've talked to a few self-published authors (some who have sold $1Mil+) of their book. Arguably some books do better as self-published works for both distribution and $.

Admittedly, there is social proof for having a book with an animal on the cover.

Congrats again on your work! I love innovative creations. (Have thought about making a Python book for toddlers...)

Re: Writing a technical book: from idea to print

#24

I am also now writing my first book ( https://efficientdeveloper.com/ ) and it is really difficult, especially during Covid times (my original idea of writing this book was writing it on a transatlantic cruise... ) What you realise when writing a book is that every sentence gets rewritten 3 times, even before you start caring about proofreading. With all the research and decision making, publishing etc. it takes much…

And if you are considering self-publishing outside of Amazon, there is a bunch more work to factor in. Some of the more successful self-pubbers I know say the sales/marketing takes more time than writing.

Re: Writing a technical book: from idea to print

#25
post #7

This is great and really useful to me! I am also, like others here, in the process of writing my first "book": https://redis.pjam.me/ . Mainly inspired by https://shop.jcoglan.com/building-git/ , rebuilding Redis, instead of git, in Ruby. > For my first few sections I wrote the code as I wrote the sections, but then Lak made the suggestion that it would probably be easier to write the code first and then write the ch…

This is a good tip. If you are writing a project/code heavy book, write the code first. They re-write the code taking intensive notes along the way. There's your outline.

Re: Writing a technical book: from idea to print

#26
post #10

Earlier quoted context omitted.

I've been working on my first book with Manning (should be out in the next few months). Without the structure a publisher provides it's likely I would not have come even vaguely close to finishing. The marketing is icing, really.

Deadlines are definitely a double-edged sword. On the one hand, they can be really inconvenient if something takes longer, other priorities pop up, you just feel you need to release a chapter even though you're not really happy with it, etc. On the other hand, in the absence of deadlines, it's easy to put things to the side for a "week" that turns into a month or two.

There are deadlines, and they helped, but a lot of it was about having someone I "owed" something to.

Another thing I did was plot my word count per commit. Once per week I would post it to an internal channel at work and add a sentence or two summarising my week. The most interesting thing is that while my output could fluctuate a lot per week, the overall trend was fairly stable.

Re: Writing a technical book: from idea to print

#27
post #6

I am also now writing my first book ( https://efficientdeveloper.com/ ) and it is really difficult, especially during Covid times (my original idea of writing this book was writing it on a transatlantic cruise... ) What you realise when writing a book is that every sentence gets rewritten 3 times, even before you start caring about proofreading. With all the research and decision making, publishing etc. it takes much…

> It took an hour to read, I thought it would take an hour to write.

Also, "If I had more time, I would have made it shorter"

Re: Writing a technical book: from idea to print

#28

Earlier quoted context omitted.

I've been working on my first book with Manning (should be out in the next few months). Without the structure a publisher provides it's likely I would not have come even vaguely close to finishing. The marketing is icing, really.

Even though I wouldn't want the publisher to make the outline of my book for me, I have to say that Manning books were some of my favourites. Their structure is pretty good.

Manning have a fair amount of docs and support for preparing a TOC, including soliciting opinions from outside experts. I imagine it's similar for other publishers.

I didn't feel like I was being made to follow a template. In fact the TOC changed a lot over the course of writing.

Re: Writing a technical book: from idea to print

#30

Having recently released a "technical" book with a large traditional publisher (Wiley) [0], here are a few of my learnings: - Expect nothing from the publisher in terms of marketing support. In fact, a good nonfiction book proposal is going to spend most of its length explaining to the publisher how you will sell the book for them through your connections and credibility - not the other way around. It's all on you. -…

I agree with this. I published the first edition of my book [1] through O'Reilly and had much of the same experiences. I would add, though, that their expertise in publishing was useful. They took care of copyediting, an ISBN, printing, redrawing my hand-sketched figures, etc. All stuff I could theoretically do or hire out on my own, but have zero interest in managing.

For the second edition, which I'm working on now, I had serious second thoughts about going with O'Reilly again. Ultimately, I decided that I would, mostly because I knew O'Reilly would be able to spread the word a lot further than I would. I've got a decent network, but not an amazing one.

The reasoning was that I'm a consultant, and the cachet, reach, and resulting leads I'll get from publishing through a known publisher are much more valuable than the theoretical profits I'm missing out on. That was certainly true for the first edition.

Having made that decision, I'm glad that I did. O'Reilly's provided a lot more support with the second edition than they did with the first. My production editor has been fantastic; heavily involved with reviewing draft chapters and very supportive. I also managed to swing a better royalty deal (but still far less than minimum wage) and we've had some great conversations about co-marketing the book.

[1] The Art of Agile Development (2007). I'm writing the second edition in the open; you can find it here: https://www.jamesshore.com/v2/books/aoad2

Post reply on HN