Bug#906949: Clarify documentation location in a Python2-less distribution

[Ian Jackson <ijackson@chiark.greenend.org.uk>]

Stuart Prescott writes ("Bug#906949: Clarify documentation location in a Python2-less distribution"):
> b) keep using /usr/share/doc/python-foo: do we stick with 
> /usr/share/doc/python-foo as a version-independent path even though no such 
> package exists once the Python 2 package is gone? (I think there are 
> currently no /usr/share/doc/ paths that don't match /usr/share/doc/$package)

This seems good to me.  You could offer a symlink.

There are two reasons for the standardised paths in /usr/share/doc:
 1. So that the user can find the right documentation.
 2. So that you avoid clashes with other packagkes.

Not moving the docs about assists 1.  As does providing a link
/usr/share/doc/python3-foo -> python-foo.

If there is no python[2] package then 2 is also served.


Alternatively, when dropping the python[2] package, move the docs but
leave a symlink the other way:
 /usr/share/doc/python-foo -> python3-foo


Both of these mean /usr/share/doc is a bit more cluttered, but people
will be able to find the thing they are looking for, and they will
minimise the impact of the `messiness' of the transition.

What do you think of that idea ?

Ian.