15

In my technical writings, I have a lot of instruction lists that describe how to use "something" under different circumstances. To avoid repetition of the subject, I replace it with "one", but it doesn't resolve the fact of the repetition itself.

A very childish example:

  • If you want to look offensive, wear a red shirt.
  • If you want to look fresh, wear a white one.
  • When you are in doubt, wear a green one.
  • If you are worried that the shirt might become dirty very quickly, wear a black one.

"one", "one", "one". Three times. What is the way to fix such a repeating without breaking the consistency? By breaking the consistency I mean something illogical, like this:

  • If you want to look offensive, wear a red shirt.
  • If you want to look fresh, wear a white shirt.
  • When you are in doubt, wear a green one.
  • If you are worried that a shirt might become dirty very quickly, wear a black one.
1
  • Comments are not for extended discussion; this conversation has been moved to chat.
    – tchrist
    Commented Jun 14, 2020 at 19:07

5 Answers 5

29

Instead of

  • If you want to look offensive, wear a red shirt.
  • If you want to look fresh, wear a white one.
  • When you are in doubt, wear a green one.
  • If you are worried that the shirt might become dirty very quickly, wear a black one.

You could introduce some variations like:

  • If you want to look offensive, wear a red shirt.
  • If you want to look fresh, wear a white one.
  • When you are in doubt, go with green.
  • If you are worried that the shirt might become dirty very quickly, try black instead.

This breaks the monotony of the repetitions without changing the meaning.

9
  • 1
    As a somewhat terser monotony breaker, one could replace the third and fourth with "When you are in doubt, where green. If you are worried that ...., wear black."
    – Lee Mosher
    Commented Jun 14, 2020 at 14:13
  • 33
    While this provides the kind of answer OP asked for, I think a correct answer would be, "You are asking the wrong question." Repetition is not a defect in technical writing. If the repetition really is extreme, it may indicate that the information should be presented in a table (as suggested in a comment under the question).
    – David K
    Commented Jun 14, 2020 at 15:41
  • 2
    Technical writing does not work like that. It's an instruction manual, not a leisure journal. Commented Jun 15, 2020 at 5:13
  • 1
    @PrimeMover the principle still applies though. Perhaps a technical writer would be more likely to say "select green" or "use black" rather than "go with green" or "try black."
    – phoog
    Commented Jun 15, 2020 at 17:14
  • 2
    @phoog A professional technical writer would not use such a flabby and wordy construction in the first place, but would present the options in a table. Commented Jun 15, 2020 at 22:19
43

My personal view is that the repeated use of "one" is not a problem at all. Tying yourself up in more and more convoluted linguistic circumlocutions so as to avoid what is at base a numinous rule: "Don't repeat yourself", is to be guarded against if you are aiming first and foremost for clarity and ease of understanding. And in the art of technical writing, clarity is foremost.

For further emphasis about the clarity of exposition, my own personal style in mathematical writing is not to use pronouns at all, because it is too easy to fall into the trap of being ambiguous, which in mathematics won't do at all.

If you do find yourself needing to repeat the same sentence pattern as in the above, you may want to think about formally structuring, for example:

"Guide to shirt colour:

  • Red: to look offensive;

  • White: to look fresh;

  • Green: if you are in doubt;

  • Black: if you are worried that it may become dirty too quickly."

6
  • 11
    +1 to "not a problem at all". Fowler, in his classic book "Modern English Usage", calls the attempts to remedy this non-problem "pointless variation" which often introduces more ambiguity. Sadly I can't find an electronic version of his rant here, but it's quite amusing.
    – abligh
    Commented Jun 14, 2020 at 13:12
  • 3
    I think Fowler called it “elegant variation” and parodied an opera synopsis. I can’t find it at the moment, but it is on the lines of switching between Ronaldo, the count, our hero and the rejected suitor. Another reason I upvoted your answer is that the question refers to technical writing, in which such variation is poison as it raises a doubt in the reader’s mind whether the author is referring to the same thing. I have beaten it out of generations of students (as we did in the good old days).
    – David
    Commented Jun 14, 2020 at 18:49
  • 2
    en.wikipedia.org/wiki/….
    – abligh
    Commented Jun 14, 2020 at 21:51
  • 4
    +1, but the readers of this answer should keep in mind that "not a problem at all" here is only in the context of technical writing. This is indeed the context of the current thread, but it's easy to miss this fact (I had initially).
    – Ruslan
    Commented Jun 15, 2020 at 15:23
  • 2
    @Ruslan No, it's not a problem at all in any context. Flowery prolixity has no place except maybe in some of the more rubbish poems written by dippy schoolgirls. Commented Jun 15, 2020 at 16:34
15

Since this is technical writing, the concise nature of tables is appropriate and may make the information easier to scan quickly. You could try something like:

Vary your shirt color to achieve different goals according to the table below:

    Goal             |  Shirt color
    ==============================
    Appear offensive | Red
    Look fresh       | White
    Express doubt    | Green
    Hide dirt        | Black

The table format helps to enforce parallel structure. It reduces redundancy in the use of "one," but also avoids repetition of the introductory, "If you want to..." and of the verb "wear..."

7

Simply drop the indefinite article and the noun.

Instead of saying wear a red shirt, simply say wear red.

If you need to mention shirts at some point, you can provide an introductory sentence to this list.

When it comes to shirts, consider the following:

  • If you want to look offensive, wear red.
  • If you want to look fresh, wear white.
  • When you are in doubt, wear green.
  • If you are worried that a shirt might become dirty very quickly, wear black.
5
  • 1
    So, red shirt, white pants, green socks, black shoes!
    – Hot Licks
    Commented Jun 13, 2020 at 17:32
  • Guy Keleny teaches that "When it comes to" is flabby journalese which is best avoided. Commented Jun 14, 2020 at 6:47
  • 2
    @PrimeMover one could nonetheless rewrite to avoid "when it comes to" without diminishing the usefulness of this answer.
    – phoog
    Commented Jun 15, 2020 at 17:16
  • @KannE That's the man. He's wise. Commented Jun 15, 2020 at 22:20
  • @phoog which is why I added it as a comment rather than expressing my disagreement with a downvote. Commented Jun 15, 2020 at 22:21
3

Personally, I would gradually simplify by dropping verbs and nouns when readers can easily infer them from the context:

If you want to look offensive, wear a red shirt. To look fresh, a white one. When in doubt, green. Worried that the shirt might become dirty very quickly, black.

0

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .