Coauthoring a ebook could be a problem. Whereas the authors share a typical purpose, every might need a special writing fashion, voice, and writing cadence, in addition to particular methods of organizing a chapter. Most of those variations are simply remedied by way of an preliminary digital session the place the authors agree on a constant fashion, format, voice, and so forth, with occasional follow-on digital classes to make sure consistency. Nevertheless, in our expertise, this isn’t sufficient.
Between the three of us, we’ve coauthored 5 extremely profitable technical books over time. This weblog submit is about three methods which have helped us overcome a number of the challenges of coauthoring, with a specific emphasis on one of the vital helpful methods: the in-person expertise.
Create a Narrative Arc
Everybody loves a great story. Tales seize our consideration for one purpose: They’ve a stable narrative arc, a literary time period for the trail a narrative follows. It’s what offers any story a transparent starting, center, and finish.
A very good story begins out with exposition to set the scene, introduce the characters, and talk the stakes. As time progresses, the strain will increase, conflicts come up, and the story turns into extra complicated. Lastly, the climax of the story unfolds, resulting in the decision and ending. That is how nice books are written—together with technical ones.
The very first thing we do in any ebook venture with O’Reilly is to collectively set up the narrative arc. This permits us to give attention to telling a narrative about our topic.
Contain Your Editor
We attribute a lot of our success to closely involving our editor within the complete writing course of. We’ve discovered that having our editor perceive our narrative arc and our fashion and voice selections pays off in spades. Your editor shouldn’t be there simply to revise your grammar: They information you thru the writing course of, educating you higher writing expertise alongside the best way and guaranteeing consistency all through the ebook.
We embrace our editor in our weekly assembly calls and our fixed textual content and electronic mail exchanges. She primarily features as a further coauthor and provides an amazing quantity to the general completed product. Make no mistake—the editor makes all of the distinction on this planet, not solely to the completed product however to the general writing expertise.
For every ebook, we create a shared Google spreadsheet that helps all of us (together with our editor) stay organized. It’s our supply of reality for which chapters every creator will draft, full with every chapter’s deadlines and present standing. It additionally contains room for brief notes on every chapter. It’s at all times open throughout our weekly conferences.
Meet in Particular person
Whereas the primary two ideas assist coauthors keep organized and centered on a typical purpose, by far probably the most precious approach we use is periodically assembly in particular person. We meet no less than twice per ebook, typically extra if we are able to prepare it logistically. Earlier than every assembly, all of us contribute to an agenda, itemizing issues we’re scuffling with or need to talk about. We meet over an extended weekend, beginning Friday afternoon and going by way of Sunday. We be sure that to take breaks and have enjoyable too: We exit to a pleasant dinner every night time and play board video games effectively into the night.
This may not appear crucial, given the benefit of digital conferences, however the outcomes of those in-person conferences have been staggering. We rotate the placement of the assembly between coauthors’ homes to ease journey prices. Though scheduling and touring to in-person conferences will be costly and logistically difficult, each time we’ve finished it, we’ve come away with new concepts and recent vitality. We’re satisfied none of those inventive concepts would have emerged with out face-to-face dialogue. There’s one thing about discussing the ebook in-person that brings new concepts and insights to mild. Every time we meet in particular person, we uncover a special approach or facet of the ebook we’re engaged on.
Listed here are some examples of how our in-person conferences have considerably influenced our books:
- After we had been planning the primary version of Fundamentals of Software program Structure, we determined to create comparability charts score the professionals and cons of every of the architectural types we had been writing about, however struggled with getting the granularity proper. After a lot frustration, we determined to fulfill in particular person and dedicate the time to the comparability charts, ensuing within the remaining model of the well-known star-rating charts discovered within the ebook. It was this expertise that satisfied us that in-person conferences are a useful a part of the success of a coauthored ebook.
- Whereas writing Software program Structure: The Onerous Elements, we discovered ourselves scuffling with the best way to contextualize every chapter’s subject. After we met in particular person, we got here up with the thought of beginning every chapter with dialogue displaying a fictional staff present process a big migration from a monolithic system to a distributed one.
- When writing Head First Software program Structure, considered one of us was scuffling with a very tough chapter. After quite a few digital conferences filled with ideas and three revisions of the chapter, it nonetheless wasn’t fairly proper. It wasn’t till our in-person assembly that all of us noticed it—the chapter was actually the wrong way up. We inverted the chapter to construct as much as the massive image fairly than beginning with the massive image, and the chapter grew to become one of many best-written ones within the ebook.
- We’re at present writing a ebook referred to as Software program Structure Patterns, Antipatterns, and Pitfalls. We created a template for every little thing we wished every sample to cowl, however it didn’t fairly work for the chapters on antipatterns and pitfalls. Via all our weekly digital calls and quite a few aspect emails and texts, we merely couldn’t appear to get it proper—one thing was lacking. It wasn’t till our first in-person assembly that we discovered the answer: altering the generic part heading “Context” to a chapter-specific query that will get proper on the level of the chapter and gives context for the antipattern.
Nevertheless, that wasn’t the magical piece. As soon as all of us noticed how effectively this labored for the antipatterns and pitfalls, we determined to make use of this system for all the chapters. Now every chapter of the ebook begins with a motivating query for why this sample, contextualizing it for each the creator and reader and making the desk of contents extra helpful. We’re assured this easy piece of brilliance would by no means have occurred by way of digital conferences.
- At that very same assembly, we additionally labored on our different present venture, Structure as Code. We modified the order of the chapters to suit a greater narrative arc on account of an intensive in-person gathering. With out being in particular person and seeing the general ebook circulation collectively, the narrative arc would possible not have modified to the brand new and improved one.
In the event you’re coauthoring a ebook, we extremely suggest having no less than one in-person gathering, if logistics permit. The success of our books must be testimony sufficient that this system works.
