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

Some people may sit back and say, "I want to solve this problem" and they sit down and say, "How do I solve this problem?" I don't. I just move around in the mathematical waters, thinking about things, being curious, interested, talking to people, stirring up ideas; things emerge and I follow them up. Or I see something which connects up with something else I know about, and I try to put them together and things develop. I have practically never started off with any idea of what I'm going to be doing or where it's going to go. I'm interested in mathematics; I talk, I learn, I discuss and then interesting questions simply emerge. I have never started off with a particular goal, except the goal of understanding mathematics.

Michael Atiyah



Navigation





<July 2014>
SMTWTFS
293012345
6789101112
13141516171819
20212223242526
272829303112
3456789

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 - 7/23/2014

Totals
Posts - 2304
Comments - 2489
Hits - 1,649,751

Averages
Entries/day - 0.57
Comments/entry - 1.08
Hits/day - 407

Updated every 30 minutes. Last: 10:16 AM Pacific


  11:35 PM

One way in which you can make editorial choices is to rule by analogy. For example, given how often we see the term username in casual writing (emails, specs, stuff written by non-writers), documentation writers will sometimes ask "So, is it username or user name?" There are various ways to research this question: consult a dictionary; consult a style guide; see what the precedent is in existing materials for your audience. If none of these resolve the question satisfactorily, you can fall back on the analogy method: it's first name and last name, so unless someone can convince me otherwise, I'll rule for user name.

I had a similar question recently about the term runtime. Programmers will often write that something or other occurs at runtime. When I got the question, I consulted the usual sources. If those had failed me[1], I'd reason that analogous phrases are at design time or at compile time. Ergo, at run time.

I emphasize that editorial reasoning by analogy should come only after other oracles have been consulted because there are times when established and accepted usage goes against analogy. For example, analogy alone might tell you that if it's folder name and volume name, it should also be file name. And indeed, that's how file name is entered in the Microsoft style guide, where they trouble to point out that it's two words.

However, in the Apple style guide, they list it as one word (filename). Because this might go against intuition (or analogy), they add this to their entry on filename:
Note the treatment of these similar terms:
    device name, host name, pathname, user name, volume name
There are lots of terms that might lend themselves to this type of analogy: homepage or home page? web site or website? If you can't find an authority to give you an answer, find terms that seem to be built on the same pattern, and then follow that.

[1] In fact, our usual sources explicitly dictate what analogy would otherwise have suggested.

[categories]   ,

[2] |