Post History
I would say that most of the time it does not apply. Suppose you are to document the use of one particular function. Good source code documentation instantly tells the user how to use that one fun...
Answer
#1: Initial revision
I would say that most of the time it does _not_ apply. Suppose you are to document the use of one particular function. Good source code documentation instantly tells the user how to use that one function. Now suppose a nearly identical function with nearly identical use exists. Bad documentation says "it works just like function x except..." and then sends the reader chasing the documentation of some other function that they aren't even using. Good documentation shouldn't force the reader to go look for information in multiple places in order to piece together the complete documented use. --- To make an example of extremely bad documentation, take for example the C language ISO 9899 standard where we want to look up a very commonly used feature called "operator precedence". All it says is this: > The grouping of operators and operands is indicated by the syntax. 85) Without any of the mentioned syntax listed. We are instead first sent to read a cryptic foot note 85), which in turn tells us to go read the syntax in each and every sub-chapter, a total of 17 chapters. The information we need is literally scattered in 17 different places of the document. While they could just have summarized it with a simple table similar to [this](https://i.stack.imgur.com/XgKf8.png). Does this repeat what is said in each of the 17 chapters? Yes. But with the aid of such a table we now have useful documentation instead of utter crap. _Do_ repeat yourself in the form of a summary, please! --- Depending on what you mean to document however, you could perhaps be smart about it and place all documentation of nearly identical functions in the same place. One example is [man strcmp](https://linux.die.net/man/3/strcmp) from the Unix manual, which lists the documentation for two similar functions `strcmp` and `strncmp` in the very same place. And now they suddenly get away with writing > The `strncmp()` function is similar, except... because all the information is easily found in one place, on that page the user is already reading.