Take a step back in history with the archives of PragPub magazine. The Pragmatic Programmers hope you’ll find that learning about the past can help you make better decisions for the future.

FROM THE ARCHIVES OF PRAGPUB MAGAZINE DECEMBER 2017

Writing: What to Expect from the Publishing Process (It Takes a Team)

By Brian MacDonald

PragPub
The Pragmatic Programmers
12 min readDec 6, 2023

--

Your proposal has been accepted. Now let Brian tell you what the next six to nine months of your life will be like.

https://pragprog.com/newsletter/
https://pragprog.com/newsletter/

Congratulations your proposal has been accepted! If youve made it this far, youve probably done a good bit of pre-writing, and youre probably anxious to get started writing. What happens next varies from publisher to publisher, but Ill lay out the basic form of what you can expect.

How long all of this takes depends on the length of your book, and your personal writing speed. Personally, I like an interval of six to nine months for writing the first draft. Thats not pushing the author unreasonably, but any longer than that, and you might start to lose interest, or prioritize other things.

Acquisitions Editor

The Acquisitions Editor (AE) is the person youve probably been talking to while you created your proposal, or the first person who contacted you after you sent your proposal to the publisher. Theyll probably handle the next few steps immediately after your proposal has been accepted, specifically, setting you up with a contract. Contract negotiations are a whole different topic that I wont go into in detail here. In general, how much room you have for negotiation depends on the publisher. Smaller publishers may not have the leeway to alter their contracts very much at all (they may not have in-house legal staff to handle it). For larger publishers, they may have so many projects going at once that it doesnt make sense to give one author specialized treatment. In short, your choices in contract negotiation may be take it or leave it.By all means, ask your editor questions about anything in your contract that you dont understand. Just dont expect to be able to choose your own terms.

Youll probably be asked about projected deadlines, or at least milestones, at this point. Most publishers will be at least somewhat flexible with these. Unexpected things can happen while youre writing a book your kid might get sick, you might change jobs, you might win the lottery all of which affect your writing time. Most publishers arent going to hold you to the exact date of your writing deadlines, but theyd like you to be close, so they can plan their schedule. Try to be as realistic as you can with your dates, and let your editor know right away if any obstacles come up.

Once the contract is signed, your acquisitions editor will probably fade into the background. Theyve got lots of books to sign, and thats where they need to focus their attention. Fortunately, theyll hand you off to a new primary contact.

Development or Project Editor

The title varies depending on the publisher, but the Development Editor (DE) or Project Editor (PE) will be your primary point of contact throughout the writing process. If anything goes wrong, or you have any questions, this is the first person to get in touch with. They may not know the answer immediately, but they can probably get it. Theyll likely also coordinate the activities of several other people involved in the process, many of whom youll never interact with directly. Exactly what they do depends on their job title.

Development Editor

Not all publishers use DEs anymore, which in my opinion is unfortunate. The DE is the first person wholl read every word of your book, and give you feedback on it. If youre very, very lucky, your acquisitions editor will also be your development editor, meaning shell have the same vision of the book that you created while you were writing the proposal, but thats very rare. Usually the DE will have a bunch of questions up front to better understand the audience, the approach, and the scope all the things you defined in your proposal, so the better your proposal, the better the DE can understand it.

As you write, youll notify the DE when chapters are ready for review, and shell read them and send you feedback according to the publishers procedures. Hopefully, the turnaround time will be pretty short (a week or two), so that you can incorporate the feedback into later chapters as you write them. DEs usually dont check your grammar; that part comes later. They take a broader view of your manuscript, and they ask a lot of questions, things like What if we switched chapters 4 and 5?or I dont think this introduction sets up the chapter well; what if you tried this?or, most commonly, You lost me here. Did you mean ?The DE is the stand-in for your reader; if the DE got lost, the reader probably will too. In technical publishing, the DE usually doesnt have experience writing code (although some do), but theyve read a lot of technical books in their career, and they can recognize the patterns of good technical writing. You dont have to automatically obey any suggestion the DE makes; the writing and editing process works best as a discussion. But you should give consideration to what she says, even if you decide not to make a change. The DE also takes on the project management functions of the Project Editor.

Project Editor

The Project Editor (PE) is the coordinator for your project. If youre working with a PE, shes likely the point person for a bunch of freelancers who will be the ones actually working on your book. Odds are youll never speak to a freelancer directly, so the PE is your primary contact for everything going on with your book. As such, you want to keep the lines of communication open. The worse thing an author can do is go silenton your PE. That works both ways; the PE shouldnt leave you hanging if you ask a question.

The PE may employ a freelance development editor, or the publisher may decide that your writing doesnt require development. If a freelancer is used, the PE will likely coordinate any queries and responses during that process.

Other things the PE (or DE) will handle include getting the marketing process started, processing illustrations (if any), and initiating the cover design. Basically, theyre in charge of the details, so you dont have to be. One of their major tasks involves coordinating the technical review.

Technical Reviewer

The Technical Reviewer (sometimes Technical Editor, or TE) is almost always someone outside the publisher, usually an expert in whatever topic the book is about. Many publishers use just one reviewer per book; some use two or three. A few publishers crowdsource their reviews, for a variety of opinions. Some reviewers are volunteers; others get a small honorarium as a thank-you. Either way, its not a replacement income. The technical reviewers are instructed to hit the book hard test every line of code, try every procedure, consider every opinion, and comment when somethings wrong. Sometimes the feedback can be overwhelming, but thats for a reason. Either tech reviewers find this stuff now, or customers find it after the book comes out, and comment on Amazon. As with the DE comments, you dont have to take every tech comment as a direct order. Sometimes theyre just differences of opinion, in which case, the person with their name on the cover gets the last word. But if a tech reviewer says that the code doesnt work on his machine, thats worth paying attention to.

Usually you wont have direct contact with the tech reviewers. Your project editor may ask you for recommendations, especially if youre writing about a specialized topic. Before you pick one of your friends or colleagues to be a reviewer, consider whether theyll give you the tough review that will really improve your book. Either way, be sure to thank all your reviewers in the books acknowledgments. Theyre providing a critical service.

Production!

The Production date is a big milestone in the life of your book. When you get to Production, your book should be feature complete” — youve said everything you want to say, crossed off any TODOs, your DE has read everything at least once, and youve resolved any outstanding queries. The publisher will likely treat this deadline as set in stone, because theres a lot of coordination around the next steps.

Everybody before this point in your books life has cared more about the content than the presentation. That is, getting your message across is more important than how you formatted a table, or whether the figure numbers were consecutive. Everybody after this point is concerned with presentation more than content, which is why you need to be feature completeat this stage. You wont normally have the opportunity to write new paragraphs or make major changes to code.

That said, this is tech publishing, and we know that sometimes major changes happen to the product youre writing about. Thats an emergency, but its one were used to. The key is communication if you think a major version of a product is imminent, let your editor know in advance. If theres a major change that you didnt see coming, let your editor know as soon as you can.

You may get a new primary contact at this point, probably with a title like Production Editor, although it varies. If there is a Production Editor, shell coordinate the next several steps, most of which are done by freelancers. If not, your development editor or project editor remains your primary contact, and should give you an outline of whats going to happen next. Some of these next steps need your input, and usually have short turnaround times. If you get confused, ask.

Copyeditor

The copyeditor (CE) is the next person wholl read your manuscript, almost always a freelancer, and she handles the grammatical issues. This is more than just commas, periods, and spelling, though. The CE remembers all the rules of writing that youve probably forgotten, knows about dangling modifiers, passive constructions, and when you should use whichinstead of that.Shes also going to be looking to improve your clarity, and adjust your writing to keep the reader engaged. Some of these changes can be rewrites. However, a good CE will use queries rather than making major changes that could affect the meaning of the text.

Unlike the DE stage, the CE will likely edit the entire manuscript in one shot, over the course of a few weeks, and you wont see it until its done. Depending on the publishers policy, you may be able to see (and possibly change) anything in the manuscript at this point, or you may be asked to just respond to the queries. Most copyeditors do a good job, but if youre uncomfortable about anything, ask your contact person. If you do see the manuscript at this point, youll probably only have a few days with it, so plan accordingly.

Proofreader

Some publishers employ a proofreader, but not all do. This role is almost always a freelancer, again, and her role is to function as another set of eyes on the book before its done. There have been a lot of changes through the development and copyedit stages, so the proofreader makes sure that nothing got dropped or moved around that shouldnt have been. She usually reads the book from beginning to end, and flags anything that doesnt look right, including any grammatical errors that got missed. If this goes well, there shouldnt be any queries, so youll only see the manuscript again at this point if theres a serious problem.

Layout Specialist

Somewhere during this process, your book will go through layout” — the process of making your text look like a finished book in the publishers house style. Exactly how this works depends on the publishers toolchain. Some publishers, especially in tech, have scripts that will take your raw text files and turn them into a good approximation of the house design, in PDF form. You may have had access to them while you were writing. Other publishers will work in Microsoft Word or another tool until after copyedit, and do the layout at that point. Either way, at some point a layout technician will go through the book and fix its visual appearance making sure figures are near the point in text where theyre discussed, making sure code blocks stay together, adjusting any spacing issues, and other things unique to the layout stage.

You should have a chance to see the book once its been laid out. At this point, youre only concerned with visual issues, not what the text says. If the wrong figure was inserted, or lines of code are getting cut off, or chapters accidentally got out of order, thats what you need to point out now. Youll probably have a very short time to do this review, often just a day or two.

Indexer

Even in this age of ebooks, indexes are still important, and theyre still created by humans. The indexer comes in as late in the book as possible, so that any changes in the copyedit or proofreading stage will be resolved. Indexing takes special training, and I dont advise that you try to do it yourself, even if the publisher offers. Instead, I suggest you make a list of the 10 to 12 items that absolutely must be in an index for your book. When you get the index for review, make sure those items are there, skim over the rest, and trust the indexer. Youll probably have about a day to review the index, so its not in your best interest to obsess over it.

Off to Print

Once all of the Production tasks are done, the book is finished. Usually the publisher will release the ebook right away, and make an official announcement about it. Youll have to wait a bit for your print copies, though (and thats what youre really looking forward to, right?). The same files used for the ebook are sent to a printer (or a print-on-demand service), and it may take anywhere from a few days to a few weeks before you get a copy, depending on the exact process, the size of your book, and how many are being printed. However its done, one of the first copies off the press should be sent directly to you, and you should absolutely celebrate as you see fit when you get it.

Marketing and Promotion

Once you have the book, youre done, right? No, of course not. Depending on your publisher, they may or may not have a marketing department to assist you in promoting your book. No matter how much your publisher assists, though, your biggest weapon is: you. You know the most about the book, and youre best suited to spread the word.

Fortunately, the best thing you can do to promote is be a good member of your community. Make yourself visible, not as a person selling a book, but as a person who contributes and shares. Speak at conferences or meetups. Answer questions on Stack Overflow (or whatever forum is appropriate for your technology). Be active on social media, talking about issues that relate to your technology. After youve contributed and helped someone, you say, And if youd like to know more, Ive written a book about this,and provide a link. If the content youre providing is valuable, potential customers will seek out your book. It sounds grass-roots and maybe a little old-fashioned, but the best way to sell your content is to prove that your content is valuable. Your publisher will have other suggestions, and maybe even specific plans, but participating will get you better results than just sitting back and waiting for the royalties.

About the Author

Brian MacDonald has been an editor of technical publications for over eighteen years. For most of that time, he ran his own business, with clients including O’Reilly, Wiley, Apress, Wrox, Osborne, and Manning. He also spent a few years as a technical writer at Microsoft. He has co-authored two editions of Learning C# and Learning ASP.NET for O’Reilly. He lives in southeastern Pennsylvania with his wife and son. You can follow him on Twitter at @bmac_editor.

Brian was the Senior Acquisitions Editor for the Pragmatic Bookshelf when he wrote this piece.

Magazine cover featuring a female with red hair hunched over a notebook writing or drawing something.
Cover of PragPub Magazine, December 2017

--

--

PragPub
The Pragmatic Programmers

The Pragmatic Programmers bring you archives from PragPub, a magazine on web and mobile development (by editor Michael Swaine, of Dr. Dobb’s Journal fame).