![[personal profile]](https://www.dreamwidth.org/img/silk/identity/user.png){kind=small}
ventaAt work, I am currently reviewing a big pile of technical documentation. Largely because no one understands it. Except the guy who wrote it, who understands it perfectly and doesn't see what the fuss is about. So I am reading, asking him questions, re-writing, asking him more questions, trying to explain to someone else, realising I don't understand at all, rinse, repeat. Everything he's written is correct, it just needs a lot more explanation and examples adding.
The writer's first language is German and, while he speaks (and writes) excellent English, he does occasionally use words in a way a native speaker wouldn't. In particular, several of us have been thrown by his describing certain objects as "contenders".
Contenders for what? we ask.
It turns out that in some cases, we might end up with conflicting objects. These objects are in contention. And a thing that's in contention? That's a contender.
Which intrigues me. A contender - one who contends - clearly is in contention. I can't fault the logic. However, I don't think that's a usage of contender which comes naturally in English.
Would any of you use contender in that way? I'm particularly interested to hear from people who might be writing (or reading) technical docs relating to things in contention :)
(I've changed it, since it confused at least three people here. I've gone for the rather more verbose "object with a conflicting ID".)
In any case, the net effect is that I have been singing Heavyweight Champion of the World on and off for two days. Which is slightly more fortunate than another colleague, who immediately associated it with Gladiators instead :)
The writer's first language is German and, while he speaks (and writes) excellent English, he does occasionally use words in a way a native speaker wouldn't. In particular, several of us have been thrown by his describing certain objects as "contenders".
Contenders for what? we ask.
It turns out that in some cases, we might end up with conflicting objects. These objects are in contention. And a thing that's in contention? That's a contender.
Which intrigues me. A contender - one who contends - clearly is in contention. I can't fault the logic. However, I don't think that's a usage of contender which comes naturally in English.
Would any of you use contender in that way? I'm particularly interested to hear from people who might be writing (or reading) technical docs relating to things in contention :)
(I've changed it, since it confused at least three people here. I've gone for the rather more verbose "object with a conflicting ID".)
In any case, the net effect is that I have been singing Heavyweight Champion of the World on and off for two days. Which is slightly more fortunate than another colleague, who immediately associated it with Gladiators instead :)
![[identity profile]](https://www.dreamwidth.org/img/silk/identity/openid.png){kind=small}
no subject
Date: 2012-09-26 09:33 am (UTC)no subject
Date: 2012-09-26 09:48 am (UTC)However, apparently I'm supposed to go for clarity, not for fun :(
no subject
Date: 2012-09-26 09:39 am (UTC)Though I do like it. Maybe I'll work on spreading that usage ;-).
no subject
Date: 2012-09-26 09:52 am (UTC)(I say almost, because Twain's advice to 'break any rule rather than say anything outright barbarous' applies in All Circumstances :) )
In general, the aim when editing bad technical writing should be to end up with something a lot shorter that contains more and better information :)
no subject
Date: 2012-09-26 09:54 am (UTC)no subject
Date: 2012-09-26 09:58 am (UTC)Examples are a Good Plan, especially if you make them relevant to what people will actually try to do with the tech, rather than just what it does. Am I alone in finding example-writing oddly fun?
no subject
Date: 2012-09-26 10:02 am (UTC)Example code is often a faff, though, because you have to write so much which isn't strictly relevant in order to provide a context for the thing that you actually want to demonstate. (Assuming you need stuff which can be compiled and run, rather than just illustrative snippets.)
no subject
Date: 2012-09-26 10:38 am (UTC)The example for 'how to make a set of decision tables rather than one humungous table' was a bit tedious, though, I'll confess :)
no subject
Date: 2012-09-26 10:58 am (UTC)See also: documentation, words which probably shouldn't appear in
:)
no subject
Date: 2012-09-26 11:04 am (UTC)no subject
Date: 2012-09-26 09:00 pm (UTC)no subject
Date: 2012-09-27 05:28 pm (UTC)no subject
Date: 2012-09-26 10:32 am (UTC)(As part of electronicifying my library, I've just bought OED's iPad dictionary/thesaurus. I haven't yet decided whether I'll also be keeping my paper Shorter OED. The paper version has more definitions of "contend" than the iPad version, but it's easier to find words in the latter. Hmmmm.)
no subject
Date: 2012-09-26 10:40 am (UTC)One colleague loves the word "timely" and just can't get using it correctly. Another has the as is/as such problem. "Since ten years" is pretty common as well.
The documents I hate reading are the ones written by a German former colleague who had a very good vocabulary and was also a show off. They have mistakes I have plenty of sympathy for but are also completely unreadable when they are correct :-)
no subject
Date: 2012-09-26 10:58 am (UTC)no subject
Date: 2012-09-26 11:03 am (UTC)There are almost certainly plenty of those in our office. I just don't have to review them :-)
no subject
Date: 2012-09-26 10:47 am (UTC)no subject
Date: 2012-09-26 10:48 am (UTC)The one I see a lot of atm in similar "parts of speech a native wouldn't get to" vein is "edition", meaning "the act of editing".
There seems to be an increasing issue where spellcheckers let a word through, but it doesn't quite mean what it might.
no subject
Date: 2012-09-26 10:52 am (UTC)I remember being very distressed as a child to realise that there were some words in English that didn't exist. If one displays precocity, one is precocious. If one displays temerity, one is...
Temerous isn't a word. And when I tried to find out what the correct adjective was, my mother coolly informed me that there wasn't one. My logical brain was horrified at this omission :)
no subject
Date: 2012-09-26 10:58 am (UTC)no subject
Date: 2012-09-26 11:30 am (UTC)no subject
Date: 2012-09-26 04:04 pm (UTC)'Timorous' suffers from its stem noun, 'timor', being lost to archaism.
'Temerity' suffers from being directly imported from French without its stem having ever been present in English afaik :-)
no subject
Date: 2012-09-27 11:11 am (UTC)no subject
Date: 2012-09-26 11:57 am (UTC)no subject
Date: 2012-09-26 01:38 pm (UTC)It returned from her tutor with some fairly terse comments about the problems of allowing horses to run the show...
no subject
Date: 2012-09-27 11:13 am (UTC)no subject
Date: 2012-09-26 02:48 pm (UTC)no subject
Date: 2012-09-26 03:06 pm (UTC)(We don't need no emulation, we don't need no source control...)
no subject
Date: 2012-09-27 04:22 am (UTC)