How to write an academic technical textbook

+

Cengage cover

If you head over to My published books page, you’ll see that I’ve written a large number of textbooks over the years for different publishers, as well as worked as a technical editor for many other titles.

Just this past week, I mentioned to a coworker that I’ve finished submitting the AU1 of the final chapter for my latest textbook Hands-On Windows Server 2019, ISBN: 978-0-357-43615-8 (I’ve revised this blog post in June to include a pic of my first printed copy).

Their response was “That’s great, but what is an AU1?” I’ve written so many textbooks that I take terms like AU1 for granted. In this blog post I’ll share the process used to write an academic technical textbook, and give some tips along the way!

The people:

There are several people involved in the development of an academic textbook, regardless of the publisher. And while different publishers vary in the number and type of these roles, most academic authoring projects involve:

  • The author (or authors if multiple people are creating content).

  • A technical editor (TE). The TE reviews everything that the author creates, verifying technical details to ensure that the content is accurate. This involves verifying technical details online, testing URLs, and ensuring that the content is technically sound.

  • One or more reviewers. Reviewers are often college instructors who teach a course that aligns well with the textbook content. Their main job is to read over the material and identify whether there are areas that they think will be difficult for their students to understand, as well as give their general impressions about content and flow. You can think of reviewers as the private beta testers for a textbook project.

  • A copyeditor (CE). The CE is a content editor that checks for grammatical errors and modifies content according to a style guide (a large set of rules for wording consistency and flow created by the publisher). They also review every sentence to ensure readability and comprehension. If there is a sentence that they do not understand, they will ask for clarity. They also check structural elements for consistency. If a sentence refers to a particular figure, key term or concept, they will check the reference to ensure that it is accurate. Copyeditors transform the content into a beautiful and consistent state.

  • A project manager (PM). The PM sets and modifies the schedule during the project. PMs typically manage several different authoring projects at the same time.

  • A developmental editor (DE). The DE is the central point of contact for all other people in the project (PM, CE, reviewers, TE and author). They distribute files as necessary and provide the communication that keeps everyone updated and on track. They also edit content for structure, flow and consistency before distributing it to others. DEs are often experienced or senior editors that have the background needed to oversee an authoring project. You can think of DEs as the movie directors for a textbook project.

The process:

The steps involved in authoring a textbook are listed below. Each step is given a deadline for completion by the PM in the project schedule:

  1. Chapters are submitted by the author to the DE. This submission is called an Author 1st (AU1) and is often a Microsoft Word document and supporting figure files.

  2. The DE sends the AU1 to the TE and reviewers.

  3. After reading through the chapter, the TE and reviewers add their comments to the chapter (using the Comments feature of Microsoft Word) and send it back to the DE.

  4. The DE combines all TE and reviewer comments into a single chapter document and edits it for flow and consistency before sending it back to the author.

  5. The author responds to all TE and reviewer comments, making associated changes (if necessary) before sending it back to the DE as an Author 2nd (AU2).

  6. The DE sends the AU2 to the CE, who performs an in-depth edit of the content (using the Track Changes feature of Microsoft Word). The CE also adds comments for sentences that need clarification (using the Comments feature of Microsoft Word) before sending the chapter back to the DE.

  7. The DE sends the copyedited chapter to the author, who accepts/rejects the changes (with rationale) and responds to all comments before returning it back to the DE.

  8. The DE releases the chapter to the production department, who composites the chapter content (including figures) to produce a finished PDF. This PDF (called the first pages) is returned to the DE.

  9. The DE sends the first pages to the author for validation. If there are problems with command spacing, figure or information layout, the author will add the relevant notes to the PDF (using the Comments feature of Adobe Acrobat) before returning it to the DE. This is called a page proof (PP).

  10. The DE sends the PP to the production department, who fix any problems and create another PDF (called the second pages) that is ready for print.

It is important to note that steps 1 through 10 are performed concurrently for different chapters on a project. As an author, you may be writing the AU1 for Chapter 5 while you are working on the AU2 for Chapter 3 and PP for Chapter 1. So you’ll need to check your schedule often and be comfortable juggling multiple different tasks simultaneously.

The prerequisites:

Every author will tell you that authoring isn’t for everyone. Creating content is always more difficult than it looks, and takes time and practice to master. In addition,

  • You must master the English language and be able to generate structured prose quickly, without having to rewrite it multiple times. If you are an avid reader, you’ll likely be a great author. If you need to rely on the Grammarly plugin, then authoring probably isn’t for you.

  • You must master the associated technical subject matter, as well as be a skilled teacher. Technical concepts must be structured and worded in a way that can be easily understood by readers. As Albert Einstein said, “If you can’t explain it simply, you don’t understand it well enough.”

  • You must avoid using idioms that other cultures will have difficulty understanding.

  • You must use direct language. For example, use in instead of within, and you will instead of a person will. The third person is for research papers only.

Other tips:

  • Planning is the most important part of an authoring project. I often spend 2-3 weeks at the beginning of each authoring project to plan the structure of each major and minor topic for all chapters (including the major tasks performed in each lab exercise).

  • Your software setup is vital during a project. Rely on virtual machines, and take snapshots regularly so that you can return to a previous state to test something later on.

  • Don’t use MacBooks to write anything (their keyboards are garbage and you won’t get much done). If you have to use a MacBook for vanity reasons, go out and purchase a good USB keyboard to use with it.

  • Remember that nothing goes smoothly in an authoring project. There will be times where a format or convention change requires that you revisit previous chapters, or times when a TE or reviewer is late submitting material, pushing back other deadlines. Never let these things stress you out, and keep current with each schedule change.

  • Stay caffeinated. Purchase enough coffee at the beginning of the project to last for about half the project duration, and keep it varied (mostly dark roast). For example, the following is what you’ll need for the first half of a 12 chapter textbook:

Coffee supply

How do I break into textbook writing?

I get this question frequently. My response is always “Why? Are you a masochist?”

But if you possess the right qualities to be a good author, the best way to break into textbook writing is to reach out to an acquisitions editor at a publisher (you can find them on LinkedIn) and let them know your background and areas of strength. In general, new book projects typically go to veteran authors for obvious reasons. However, when a publisher has a need for a book in a new topic area where an existing author is unavailable, you may be offered the book project!