Hacker News new | ask | show | jobs
by roflchoppa3 2075 days ago
dude i really want to know this, i can speak English pretty well. But have a difficult time writing grammatically correct documentation for our project. >.> I feel like I look stupid when someone returns a PR that has grammar errors.
3 comments

I'm assuming English isn't your first language? Don't feel too bad - I see mistakes in native speaker's writings on a daily basis.
Writing documentation is 100% where the smallest bugs in your english skills come out, whereas speaking allows so much more in the way of context clues to let grammar mistakes slide. It's so tough. If it's any consolation, I have corrected documentation grammar errors from native speakers too
Here in HN I sometimes end up writing several simple sentences instead of a single complex one, because I'm not sure about the grammar, but sometimes that looks awkward.
It worked for Hemingway! My English teachers always advised splitting meandering sentences in half. I have never regretted doing so.