On my TeX Live installation there are about 200 Makefiles installed in the
texmf-dist/doc subtree. They, of course, hardly count as documentation. Even strangier their placement seems in light of that every TeX Live package also has a source archive, where (and only where) the Makefiles would normally go.
However, this doesn't seem to be an unnoticed mistake, as even
texdoc knows enough about them to have an exception rule:
> texdoc -d impatient . . . texdoc debug-score: Start scoring /data/texlive/texmf-dist/doc/plain/impatient/Makefile texdoc debug-score: Name used: impatient/makefile texdoc debug-score: Start heuristic scoring with pattern: impatient texdoc debug-score: New heuristic score: 1. Reason: subword match texdoc debug-score: New heuristic score: 0.1. Reason: bad extension texdoc debug-score: New heuristic score: 1.6. Reason: directory bonus texdoc debug-score: Final heuristic score: 1.6 texdoc debug-score: Max pattern score: 1.6 texdoc debug-score: Adjust by -1000 from global pattern '/makefile' <=== texdoc debug-score: Final score: -998.4 . . .
Why are the Makefiles placed in the documentation subtree?