https://bugzilla.redhat.com/show_bug.cgi?id=2092637
--- Comment #5 from Ben Beasley code@musicinmybrain.net --- (In reply to Major Hayden 🤠 from comment #2)
I was packaging the docs previously for these google cloud packages, but then I ended up in some challenging situations with sphinx trying to refer to other bits of documentation that it couldn't reach during an RPM build.
If you wanted to package the documentation, you would need to ask sphinx for PDF output instead of HTML (see bug 2006555 and the linked packaging mailing list discussion). Then you could do something like:
# Drop intersphinx mappings, since we can’t download remote inventories and # can’t easily produce working hyperlinks from inventories in local # documentation packages. echo 'intersphinx_mapping.clear()' >> docs/conf.py
to stop it from complaining about intersphinx mappings. See https://src.fedoraproject.org/rpms/python-aiosignal/ for an example, and let me know if you want a PR to enable documentation on any of these packages.
However, packaging generated documentation is *not* required, and in many cases may not be worth the trouble.