#1098648 grpcio: Please provide a -doc package for python3-grpcio, e.g. python-grpcio-doc

#1098648#5
Date:
2025-02-22 07:28:50 UTC
From:
To:
Hello Laszlo,

could you please provide also a -doc package for the python3-grpcio
package?
Most of such package are named in the DPT in a way that the name for the
additional package would be here python-grpcio-doc and contain the HTML
documentation in the folder

/usr/share/doc/$(package_name)/html

For example

https://packages.debian.org/sid/all/python-werkzeug-doc/filelist

The advantage of such packages is we can use the object.inv files from
these packages while building other -doc packages so we have a usefull
interlinking between the documentations. This requires the other linked
to packages are installed on the system of course.

I will try to provide some patches or a MR to src:grpcio so the new
package could be added more easily.

The Sphinx based documentation can be found upstream here:

https://github.com/grpc/grpc/tree/master/doc/python/sphinx

Regards & Thanks
Carsten

PS: I'm sitting right now on preparing some Python OpenTelemetry
packages and here python3-grpcio is needed as a binary dependency and
the object.inv file from the documentation under
https://grpc.github.io/grpc/python/ is used in the docu.