As many of you know, I am struggling to edit my eight hundred page, very technical book. It has had no editorial passes, none, and had to be stopped in production so I could salvage it.
The problem with that, well, there are a host of problems. It would be more appropriate to ask where to start when trying to explain why that’s a problem. But one of the biggest problems is I am editing eight hundred pages of what were originally Word 2003 documents in PDF, with Adobe Reader.
Ever try it? No? Good. That explains why your eyes point in the same direction enough to read this post.
Suffice it to say that it is a bad format to rewrite entire chapter sections, insert pictures, change the format of words, paragraphs, heading levels, and lists. It’s okay for making comments. It’s okay for highlighting some words, or making little callout boxes to make more pointed comments. It is not good for real, first time through editing.
Sigh.
In addition, and I doubt this is true for books outside of the technical field, there are strict guidelines as far as styles, where to apply them, and why. As an author of a book with those guidelines, I have to spend time carefully formatting every aspect of the chapter, with inlinecode character formats, inlineURLs, uservariables, run-in headers, titles, and manually numbered number lists (yes, we cannot use automatic numbering for eight hundred pages of step by step lists because Quark can’t handle autonumbered lists– and that means, for those of you keeping score, that you have to number all of your figure references and figure labels manually).
—And it’s all this formatting that makes the proofreader so critical. Yeah, people might think the proofreader is superfluous. But they are the ones that ensure that the other editors and compositors don’t ruin the logical design and flow of the book. So follow along and you’ll see that, after all of this, why my proofreader (if they actually do their job and stick to their guns) will be my knight in shining armor.—
So all data in the book is formatted and strictly organized by the style guidelines for the book line. These are technical books, teaching linearly something that may well not be linear. But, nonetheless, it has to be attempted because the reader needs to be have some sort of landmarks to indicate where descriptions are in relation to each other. A header indicates the start of a section. That section contains tables, lists, steps, etc. Lists can contain sublists, with sections all their own. It’s a nightmare.
For example, if you are describing a configuration page that is broken into task sections, and in each section are several settings– some of which are dynamic, and trigger the propagation of more settings if enabled,–you need to lay out the information in a way that indicates, at a glance, what content contains other content (if that makes sense).
When describing the page, you first explain what the page is for, why use it, and how to get to it. Then to linearly, without pictures, describe the page’s content, you first need to layout the different sections, then within the sections go into detail about the settings. Therefore you need to format the information so that the configuration page title is a Title heading, that indicates that what follows is important, and falls under that heading. Then for the sections on the page, is another, subordinate heading that would be indented, indicating that it is contained, or below the Title heading’s information. Then, for the settings in each section, they could be indicated with a bulleted list, again indented a level further, indicating that that list is contained, or beneath the subordinate heading.
In the case of my book (supposedly following a preexisting style guideline), that subordinate heading would be called a Run-in header. So an example would be (this data is actually accurate but you don’t need to read it in detail to get the point–please ignore the Quote graphic– the book won’t have that):
Configuring Incoming E-Mail (consider this a Title Heading)
Incoming email is a feature new to this version of the product. At its simplest configuration, it allows lists and libraries to receive incoming email and process them as list or library items. In addition, Directory Management Service (DMS) can be enabled, allowing site groups to have distribution lists and individuals in those groups to receive emails sent to the distribution list. In addition, it creates contact objects for all e-mail enabled lists and libraries, giving them a contact record in the Exchange Global Address List. To get to the Incoming E-Mail settings, open Central Administration, go to the Operations page, and click Incoming E-Mail Settings.
In the configuration page for Incoming E-Mail there are several sections; Enable Incoming E-Mail, Directory Management Services, Incoming E-Mail Server Display Address, and Safe E-Mail Servers. In each section are settings you can configure to further customize Incoming e-mail. Below is a summary of what each section is, and what settings it contains:
Enable Incoming E-Mail (consider this a run-in header)
This section contains settings to enable Incoming E-Mail, as well as specify the SMTP service’s e-mail drop folder.
- Enable sites on this server to receive e-mail? This setting is simply two radio buttons, Yes and No. No is selected by default. To be able to configure incoming e-mail you must first enable it. When Yes is chosen the next setting in this section becomes available.
- Settings Mode. This setting has two options: Automatic and Advanced. Automatic will use the default IIS SMTP service drop folder for all incoming e-mail. Advanced will display a field in which to specify the custom path for storing incoming e-mail.
Directory Management Service
This section allows you to enable DMS, which integrates with Active Directory and allows all lists, libraries, and site groups to have contact or distribution group objects in AD and Exchange. This section has three radio button options: Yes, No, Use Remote. No, which is the default, causes all other settings for DMS to be hidden. Yes enables DMS and triggers the display of the settings necessary for configuring the feature. Use Remote enables DMS and triggers the display of the fields necessary for indicating what other server is actually supporting DMS.
- No. Disables DMS, clears the section of settings. If you disable DMS, it does not delete the entries for the lists, libraries, or site groups that might already be in AD.
- Yes. Enables DMS. Triggers the following settings:
- Active Directory Container. Enter the OU in AD that will contain the contact or distribution group objects for DMS. The OU=X,DC=X, DC=X format must be used.
- SMTP Mail Server. This field must contain the server address of this server, the one hosting DMS.
- Accept messages from Authenticated Users only. This is a Yes/No setting.
- Allow distribution groups. A Yes/No setting, this can be used to block the use of distribution groups if they are being abused without having to disable DMS entirely.
- Use Remote. Enables DMS, but offloads the service by redirecting requests to a different server. Triggers the following settings:
- Directory Management URL. Enter the URL for the server hosting DMS. Point that the asmx page containing the DMS settings, which is typically SharePointEmailWS.asmx.
- SMTP Mail server address. The address for this server.
- Accept messages from Authenticated Users only. Yes or No setting.
- Allow distribution groups. Yes/No setting. Again, just allows you to block distribution group creating while still allowing contact creation for lists and libraries.
Incoming E-Mail Server Display Address
This setting allows you to specify the domain address that will be displayed and used for the lists, libraries, and site groups. Each of these items, once this feature is enabled, will have the option of specifying an e-mail address using an alias@serverdisplay.address.
- Email Server Display Address: This setting is a field to contain the display e-mail address for the lists, libraries, and site groups to use. The data in this field will have the alias of the incoming e-mail lists, libraries, and groups tacked onto it.
————————————————————————————————————–
…And so on from section to section, setting to setting. You can see that the organization of the data is pretty important in order to keep that data logical.
Here is that same data, without formatting. See if it makes a difference to you:
Configuring Incoming E-Mail
Incoming email is a feature new to this version of the product. At its simplest configuration, it allows lists and libraries to receive incoming email and process them as list or library items. In addition, Directory Management Service (DMS) can be enabled, allowing site groups to have distribution lists and individuals in those groups to receive emails sent to the distribution list. In addition, it creates contact objects for all e-mail enabled lists and libraries, giving them a contact record in the Exchange Global Address List. To get to the Incoming E-Mail settings, open Central Administration, go to the Operations page, and click Incoming E-Mail Settings.
In the configuration page for Incoming E-Mail there are several sections; Enable Incoming E-Mail, Directory Management Services, Incoming E-Mail Server Display Address, and Safe E-Mail Servers. In each section are settings you can configure to further customize Incoming e-mail. Below is a summary of what each section is, and what settings it contains:
Enable Incoming E-Mail
This section contains settings to enable Incoming E-Mail, as well as specify the SMTP service’s e-mail drop folder.
Enable sites on this server to receive e-mail? This setting is simply two radio buttons, Yes and No. No is selected by default. To be able to configure incoming e-mail you must first enable it. When Yes is chosen the next setting in this section becomes available.
Settings Mode. This setting has two options: Automatic and Advanced. Automatic will use the default IIS SMTP service drop folder for all incoming e-mail. Advanced will display a field in which to specify the custom path for storing incoming e-mail.
Directory Management Service
This section allows you to enable DMS, which integrates with Active Directory and allows all lists, libraries, and site groups to have contact or distribution group objects in AD and Exchange. This section has three radio button options: Yes, No, Use Remote. No, which is the default, causes all other settings for DMS to be hidden. Yes enables DMS and triggers the display of the settings necessary for configuring the feature. Use Remote enables DMS and triggers the display of the fields necessary for indicating what other server is actually supporting DMS.
No. Disables DMS, clears the section of settings. If you disable DMS, it does not delete the entries for the lists, libraries, or site groups that might already be in AD.
Yes. Enables DMS. Triggers the following settings:
• Active Directory Container. Enter the OU in AD that will contain the contact or distribution group objects for DMS. The OU=X,DC=X, DC=X format must be used.
• SMTP Mail Server. This field must contain the server address of this server, the one hosting DMS.
• Accept message from Authentication Users only. This is a Yes/No setting.
• Allow distribution groups. A Yes/No setting, this can be used to block the use of distribution groups if they are being abused without having to disable DMS entirely.
Incoming E-Mail Server Display Address
This setting allows you to specify the domain address that will be displayed and used for the lists, libraries, and site groups. Each of these items, once this feature is enabled, will have the option of specifying an e-mail address using an alias@serverdisplay.address.
Email Server Display Address: This setting is a field to contain the display e-mail address for the lists, libraries, and site groups to use. The data in this field will have the alias of the incoming e-mail lists, libraries, and groups tacked onto it.
——————————————————————————————————————–
…. Can you see the difference? Can you see why using some formatting makes it easier at a glance for a reader to distinguish the jist of what’s going on?
Well, guess what? I wrote with formatting like the first example, and what I got back in galleys from the compositor was much, much closer to the second example. Seriously, and what comes back from the compositor is exactly as it will be when printed (remember galleys are print proofs). In some cases there was still remnants of larger fonts or bolding, but none of the indents.
Why? Because of a tragicomedy of errors (email me for more information– I can’t safely speak my mind until the book is published, but the story is both grim and juicy) the book is three months late and the compositor is under pressure to conserve page count and that means that they are pushed to eliminate indents.
Yes, eliminate indents. Seriously. You might think that’s ridiculous, but in order to save space, they want everything to go margin to margin. That also means that paragraphs and word spacing is literally kerned as well. They have eliminated the spaces between the pararaphs, even the ones that are numbered and the paragraphs that follow as well.
I’ll try to show an example, but wordpress will not allow me to have a numbered list without a following space:
- this is the first step.
- this is the second step.
- this is the third step.
- Make Believe that this sentence is actually a different paragraph moving on in the teaching of a concept and is not numbered. This is a different paragraph altogether, but to conserve space, the compositor is not going to put a space in to indicate the transition. There are no spaces between bulleted or numbered lists and the paragraphs around it. Everything is completely crowded together. Meanwhile, there is too much space before and after figures in order for the figures to fit an archaic rule of being a third of a page by default.
And these are only the first few intentional “mistakes” the compositor did. Others were to kern the sentences in paragraphs (particularly sidebars for some reason) so that the words all run together with no spaces between them (so if you double click to select a word, it selects the whole sentence, or worse, the whole paragraph). Figures were also moved so that up to seven at a time were stack near or at the end of chapters, pages and pages away from their text references. In addition, all sidebars were formatted incorrectly, with a neat space saving trick– every paragraph is missing a space after it, and there is no indent to indicate the paragraph is there, saving space all around.
So why is a proofreader so important?
Well, my editor informed me that formatting changes, especially spacing, were not allowed. (can you believe it?!) Of course, the production editor, following her job description, had given my chapters to the proofreader. And, apparently unbeknownst to my editor, that proofreader had even complained about these formatting issues.
And guess what? Because the proofreader said it was a problem, the problem may well get fixed.
And if it doesn’t? Well, you now know that maybe, just maybe, the author didn’t write it that way. That maybe, just maybe, the author is not to blame for something that the publisher chose to do to save money. And if the proofreader gets her/his way, well I, for one, am grateful. Really, really grateful.
So now you know.