←back to thread

262 points jumpocelot | 1 comments | | HN request time: 0.001s | source
Show context
AdmiralAsshat ◴[] No.44524146[source]
Most of this looks quite good!

The only part that throws me for a loop is in the Grammar section, which contains a mix of best practices (like "Prefer active voice to passive voice") mixed with basic rules about subject-verb agreement. The former is what I would expect to see in a Style Guide, while the latter is, I dunno...what I would expect as a basic requirement for passing high school English?

It just feels like for the level of fluency presumably required for a Technical Writer, basic grammar rules should be well understood and not need to be explicitly stated.

replies(6): >>44524184 #>>44524285 #>>44524290 #>>44524658 #>>44526636 #>>44531050 #
dmurray ◴[] No.44526636[source]
I expect even quite literate native English speakers to sometimes make mistakes with subject-verb agreement in any form of sentence other than the most trivial.

E.g. I am not surprised to read "Distance to the server is one of the factors that affects latency."

replies(1): >>44526951 #
scoot ◴[] No.44526951[source]
And I'm not surprised to see "e.g." being used incorrectly. ;)
replies(2): >>44527688 #>>44531090 #
1. ruraljuror ◴[] No.44527688[source]
Looks right to me. Are you referring to the capitalization?