discuss: Avr-Microcontrollers-in-Linux-Howto - review needed
Subject:
Re: [discuss] Avr-Microcontrollers-in-Linux-Howto - review needed
From:
Borden Rhodes ####@####.####
Date:
15 Mar 2009 08:47:06 +0000
Message-Id: <432cd8760903150142l39015323q7400a3992467f593@mail.gmail.com>
I've done some (at least, what I think is) basic grammatical and
spelling corrections to the article. For a first draft, I found it a
good read and, almost entirely, quite clear. However, since I don't
have the hardware in question, I can't verify the article's accuracy.
I have one stylistic comment: the article uses Latin abbreviations
including 'i.e' and, more frequently, 'etc.' I would avoid using
these for two reasons: first, English is perfectly capable explaining
without falling back on other languages. I hope the author will
forgive me for replacing the an occurrence of 'i.e.' with its
translation, 'that is.' Secondly, when one uses 'etc.,' it glosses
over information which, although obvious to the author, may not be
obvious to the reader. Worse, 'etc.' was used in a few places to end
a sentence and start a new one which really belonged with the previous
sentence.
Anyway, my ignorant white guy suggestion is to expand the 'etc.'s to
their assumed items. If what 'etc.' is taking the place of should be
so obvious to the reader that you only really need mention a few from
the set, may I recommend a form like "go buy the usual groceries, such
as eggs, milk, cheese, and lettuce" as opposed to "go buy eggs, milk,
cheese, lettuce, etc."
On the whole, though, great article! I look forward to reading its
revisions. Good luck on your exams!
Borden
On 14/03/2009, jdd for http://tldp.org ####@####.#### wrote:
> I just converted the first draft of this HOWTO to the wiki.
>
> http://wiki.tldp.org/Avr-Microcontrollers-in-Linux-Howto
>
> if any people with microcontroller technical skill can get a look...
>
> The author being not english native, langage review is good also.
>
> This is only a first draft. The author is having exams and will go
> ahead after that :-)
>
> jdd
> --
> jdd for the Linux Documentation Project
> http://wiki.tldp.org
> http://www.dodin.net
> http://www.facebook.com/profile.php?id=1412160445
>
> ______________________
> http://lists.tldp.org/
>
>
