English Language & Usage Stack Exchange is a question and answer site for linguists, etymologists, and serious English language enthusiasts. Join them; it only takes a minute:

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

I'm planning on writing a blog about computer programming, and I'm having trouble finding the right voice. I'm looking for something that feels personal and conversational. Third person seems sterile, first person singular comes across egotistical, second person comes across as bossy.

I've been using second person plural, which has an inclusive feel to it, but that takes away from the conversational feel of the non-technical parts of the piece.

Here's a quick example:

Let's say that we have a pipe delimited text file called 'addresses.txt' where
the first line of the file is a header with column labels:

 First Name | Last Name | Street Address         | City        | State | Zip   |
 Homer      | Simpson   | 742 Evergreen Terrace  | Springfield | OR    | 97477 |
 Marge      | Simpson   | 1094 Evergreen Terrace | Springfield | MO    | 65802 |
 Bart       | Simpson   | 1092 Evergreen Terrace | Springfield | IL    | 62704 |
 Lisa       | Simpson   | 59 Evergreen Terrace   | Springfield | ME    | 04487 |
 Maggie     | Simpson   | 94 Evergreen Terrace   | Springfield | WI    | 53176 |

We can use a for loop to pull and print each field of the header

for i in {1..6};
    header="$( head -1 addresses.txt |  cut -d '|' -f $i )"
    printf "%d: %s\n" $i "$header"

This works when I'm describing how I want the reader to write a piece of code, but it doesn't work when I'm describing the programming language as a whole:

The Bourne shell is a full fledged programming language, complete with
branching and looping constructs.  These constructs can be used on the
command line, affording us a great deal of expressive power without a
lot of typing.

This comes across as dry, and the token 'affording us' is weak. Furthermore, writing the whole blog in the first person plural seems artificial.

How should I approach this?

share|improve this question

closed as off topic by tchrist, Kris, Jim, Andrew Leach, Jon Hanna Feb 4 '13 at 15:06

Questions on English Language & Usage Stack Exchange are expected to relate to English language and usage within the scope defined by the community. Consider editing the question or leaving comments for improvement if you believe the question can be reworded to fit within the scope. Read more about reopening questions here.If this question can be reworded to fit the rules in the help center, please edit the question.

giving (us) instead of affording us – mplungjan Feb 4 '13 at 14:28
Try writersSE the appropriate Q&A for writers. – Kris Feb 4 '13 at 14:49
There is nothing wrong with affording, and your use of token in describing it is not clear. – Robusto Feb 4 '13 at 14:50
Off topic (writing advice). You might try Writers.SE but please check the FAQ there before posting. Thanks. – MετάEd Feb 4 '13 at 14:53

Perhaps the following:

The Bourne shell is a full fledged programming language, complete with branching and looping constructs. We can use these constructs on the command line. This gives us a great deal of expressive power without a lot of typing.

You can mix third person sentences, which generally describe qualities with first person sentences or clauses which describe actions.

share|improve this answer

I would use a friendly, informal tone. The main point is to communicate your thoughts and insights,so do it in a way that you feel comfortable with. Good luck!

share|improve this answer

Not the answer you're looking for? Browse other questions tagged or ask your own question.