Some packages have both a hand-written .doc-base file and a .doc-base file generated from Javadoc, and non-deterministically install one or the other. Example: https://bugs.debian.org/1001218
Our notes about issues affecting packages are stored in notes.git and are targeted at packages in Debian in 'unstable/amd64' (unless they say otherwise).