Hacker News Reader

I said it "stops being just that." You removed the word "just" which changes the entire meaning of the sentence.

Sorry, one can read "just that" in two ways there, "it at all" or "only".

To carry on with your intended meaning, what is the problem if the technical documentation is more than just technical documentation? We're talking about a paragraph here, maybe 0.1% of the documentation. Are you making a claim that at some percentage of non-technical content the documentation becomes illegitimate?

I'm honestly just trying to understand what you're getting at.

Possibly I should have said "it stops being only that," that might have been more clear. The problem with making that 0.1% into something else is that people still get annoyed and distracted by it because it's not what they expected, and they complain, which is exactly what happened here.

Reply on news.ycombinator.com