On Tue, Jul 16, 2013 at 2:00 PM, Daniel P. Berrange <berrange@redhat.com> wrote:

If a package installs HTML docs into /usr/share/doc/<name>-<version>
and you want to bookmark that in your web browser, then your bookmarks
break everytime the RPM is updated :-(

Yes, and like said in the proposal, it's not limited to HTML and browser bookmarking. Cross referencing other packages' docs (from other HTML or plain text docs, scripts, code, systemd unit Documentation= or whatever) is similarly affected.