How to be Edited

The key to survive being edited is not to look at the edits.

There is a lot of advice available on how to edit other people’s work, and how to edit your own, but not much on how to be edited by someone else. Here’s some thoughts on how to make it a relatively less agonizing process. The key is, don’t look at the edits, look at the result.

The agony of being edited

I’m nearing the end of having my book edited. I submitted the “final” manuscript a couple of weeks back, and since then my editor and publisher, Richard Hamilton of XML Press, has been copyediting and feeding the result back to me a chapter at a time. Since one of Richard’s stated aims in the copyedit was to trim back the manuscript significantly, I was prepared to this to be a painful process. read more

Readers Express their Purpose in Terms of Tools and their Features

One of the samples of an EPPO topic that I included in my book was a topic from the WordPress Codex on the subject of Using Themes. One of the key properties of an EPPO topic is that it serves a specific and limited purpose. I identified the purpose of this topic as enabling the reader to use themes on their WordPress site.

One of the reviewers objected that the user’s real purpose was not to use themes, but to style their site. I can understand where the criticism comes from. Those of us who favor task orientation in technical communications are quite sensitive to anything that smells of its opposite: feature orientation. We don’t want people to be writing topics on the File Menu, for instance. We want them to focus on things that the reader is trying to do. read more