DEV Community

Discussion on: Technical Writing: Mistakes I've made.

Collapse
 
dmbaturin profile image
Daniil Baturin

I'm not the biggest fan of comma splices, but I never criticize people for them. What are the sins of the "She’s an outstanding student, she’ll go far." sentence, if any? The meaning is clear. It's not hard to parse. Its only sin is that it's against some styles guides (but for every style guide, there's one that is equally respected and says the opposite ;).

Dangling participles really make sentences hard to read, or even ambiguous, no arguing there.

Anyway, I've read excellent articles that had not only style problems, they had grammar and spelling mistakes. But, they were very instructive.
My advice to a hypothetical novice technical writer would be: if you've got extra time, spend it checking facts first and style last.