Comment by ignoramous

> Being short and concise is usually the better way.

The golang docs are like this. As a novice, you are looking for detailed prose, but as you progress, you come to appreciate the terseness.