Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

What? If you're writing software being able to produce clear documentation, write-ups, and other supplemental materials is quite important. In some cases, far more important than writing the actual code.

In some hires I've used a descriptive writing assignment, where I ask the candidate to describe in words what they are looking at. You can learn much from these things, including: analysis skills, close looking, how they think, and, well, how well they would document their software.



> What? If you're writing software being able to produce clear documentation, write-ups, and other supplemental materials is quite important. In some cases, far more important than writing the actual code.

You are taking it to the extreme where there are only 2 states: grammar purists and monkeys banging at keyboard. Someone who mixes up "its" and "it's" is capable of all the important stuff you listed. I mix "its" and "it's" a lot while typing. I know the difference, my fingers don't.

> analysis skills, close looking, how they think, and, well, how well they would document their software.

And none of it is a result of good grammar. Are you implying that somehow good grammar leads to good analytic skills? Or are you saying talking with them gives you a window to their mind? If the latter, the window is wide open irrespective of how often I mix "it's" and "its". And how I prefer my period outside of quotes or parens(Why? Because I like it that way. That's why).


So teach yourself not to make the mistakes because the next person in behind you working on your code might not know what you mean. If you know the difference it's just laziness to not communicate correctly.

As for periods outside of parentheses or not, that's syntax, not grammar. Your position here is weak. Good grammar is an indication that the person wielding the language at least takes care over what they're doing. A valuable trait for anyone, no matter what.


> So teach yourself not to make the mistakes because the next person in behind you working on your code might not know what you mean.

For the nth time, I am not talking about "monkeys banging on keyboard" grammar.

> As for periods outside of parentheses or not, that's syntax, not grammar

Syntax is not grammar?

It isn't that hard to fact-check before confidently correcting someone.

http://en.wikipedia.org/wiki/Syntax

> Good grammar is an indication that the person wielding the language at least takes care over what they're doing.

Good grammar is an indication of good grammar, and that's that. If you believe it's otherwise, well, your believes aren't fact. Please provide citations.


"...If you're writing software being able to produce clear documentation, write-ups, and other supplemental materials is quite important. In some cases, far more important than writing the actual code."

Does the company in the original post not recognise the function of an editor?




Consider applying for YC's Winter 2026 batch! Applications are open till Nov 10

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: