I can understand the reasoning for avoiding same line docs in the code base, but for succinct code examples I think they make sense.