>The first three quotes were great. No need to ruin it with the last.
I disagree: the quote made me curious to read the context which I may have not done if the quote was less provocative.
As an aside, I somewhat disagree with Russel King: I don't find the documentation clear *at all* (but I'm not a kernel dev so I lack context) but I agree with him that adding text is not always the best way though.