I figured that “There are two types of bad software documentation: math textbooks and cooking recipes. The former does not explain why you are doing things and other helpful context, the latter won’t help you if you need to do something differently, which is almost always.” ahartmetz - on HN