I don't think he's advocating for shortening the docs, if you look at the example he gave, his improved version was much longer: it explained each argument in d

I don't think he's advocating for shortening the docs, if you look at the example he gave, his improved version was much longer: it explained each argument in detail as well as the return type, and gave an example.