About

I'm Mike Pope. I live in the Seattle area. I've been a technical writer and editor for over 30 years. I'm interested in software, language, music, movies, books, motorcycles, travel, and ... well, lots of stuff.

Read more ...

Blog Search


(Supports AND)

Google Ads

Feed

Subscribe to the RSS feed for this blog.

See this post for info on full versus truncated feeds.

Quote

Furrygoat's Law: Every program expands until it can read RSS feeds.

Steve Mafosky, based on Lett's Law: All programs evolve until they can send email.



Navigation





<December 2014>
SMTWTFS
30123456
78910111213
14151617181920
21222324252627
28293031123
45678910

Categories

  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  
  RSS  

Contact

Email me

Blog Statistics

Dates
First entry - 6/27/2003
Most recent entry - 11/24/2014

Totals
Posts - 2316
Comments - 2506
Hits - 1,692,610

Averages
Entries/day - 0.55
Comments/entry - 1.08
Hits/day - 404

Updated every 30 minutes. Last: 12:54 AM Pacific


  01:01 PM

John McIntyre has a post today about using evidence to support assertions about language, and I've been thinking anyway recently about the need for empirical support for things like planning your documentation. (More on that another time.) Thus I was primed today while I was editing to think about edits I make that I really can't justify.

The writer David Owen said once that early in his career he interned for someone who "maintains an idiosyncractic but absolute ban on the word however."[1] Every editor has terms — words, phrases — that they just don't like. A word seems ungainly to them, or it violates some bogus rule that the editor once learned, or ... well, whatever. It's subjective, but in each case it's specific to that editor and can't be justified in the usual ways. (Logic, precedence, or appeal to authority.)

So for a little Friday Fun, here's a list of edits I make that have no more justification than "because I don't like it." :-)

upon
Custom Formatting Based Upon Data [#]

The number of times in which I think upon is better than on is so small that I can't remember the last time I let upon stand.


within
ASP.NET MVC 3 and the @helper syntax within Razor [#]

My ban on within isn't quite as absolute as it is on upon; there are times when it does clarify. (Something like The rule constrains the numbers to those within a specific range.)


desire, desired
Windows Server 2003 ships a new ‘Configure Your Server Wizard’ to help you properly configure your server in the desired mode. [#]
[A]n advanced HTTP handler designed to enable file protection for any file you desire. [#]

I am on a personal mission to stamp out desire in technical docs. C'mon, it's just want. And not just that. My experience is that desired is almost always a way to avoid saying youthe desired mode really just means the mode you want.


wish (as in, any option you wish)

Same as desire, tho my aversion to wish is milder than it is to desire. Just use want, already. Anyway, there are uses I am ok with, like wishlist.


we/let's/our
Now let’s run the site. We can start our web-server and try out the site using any of the following. [#]

This one practically makes me froth at the mouth; I mean, my reaction really is irrational. To me, we and let's sound gratingly condescending — I refer to it as "nurse talk" (How are we feeling today?). Obviously most people are just fine with it; practically every tutorial I edit starts off talking about "we" are going to do this or "let's" add a page to "our" website and so on. And the ones I can't get my hands on are out there in the world and people love them. Nonetheless, if I'm given a chance, I discreetly change every we to you and our to your. The only exception I'll make is if the text really is talking about we to mean "we, the authors," as in We have designed this tutorial to show you how to ... or whatever.


There are other such things, tho they're less obvious. No matter how many times Geoff Pullum tells us that which is okay for a restrictive relative (I know this! I agree, even!), I reflexively change it to that. Ditto for only, which has a very free position in sentences, but which I often (again, reflexively) scooch over so that it's closest to the thing it modifies.

So there you have it ... some True Confessions about my editing. You might want to argue with me that some or all of these are just fine, there's no need to edit these things. I would be obliged to agree, as long as I'm being reasonable. The point is, tho, that they just bug me. And I don't think I can be talked out of that.


[1] David Owen, "The Fifth Estate," The Atlantic Monthly, July 1985.

[categories]   ,

[5] |