> No one wants to know about the three other approaches tried when reading the first sentence of a function's documentation. Worse: Possibly the three other ap

> No one wants to know about the three other approaches tried when reading the first sentence of a function's documentation. Worse: Possibly the three other approaches that weren't actually tried--but are the kinds that someone could easily have put in a similar comment for some similar code.