On 8/11/22 10:23, Ben Beasley wrote: > I don’t enjoy this topic at all, but I feel obligated to contribute some > relevant links. > > A previous discussion on the packaging mailing list[1] concluded that it > doesn’t seem possible to package HTML documentation generated by almost any > system, including at least Sphinx, Doxygen, and mkdocs, in a way that > complies with guidelines around pre-compiled and bundled JS, CSS, and fonts. > See also [2], which started that discussion. > > There might be a conflict between this situation and certain > language-specific guidelines that prescribe packaging standardized > documentation packages. For example, [3]. > > [1] > https://lists.fedoraproject.org/archives/list/packag...@lists.fedoraproject.org/thread/LLUAURXZVADATHK65HBPPBHKF4EM4UC3/ > [2] https://bugzilla.redhat.com/show_bug.cgi?id=2006555 > [3] https://bugzilla.redhat.com/show_bug.cgi?id=2097267
The best solution here is to patch Sphinx and Doxygen so they do not produce nonredistributable output. -- Sincerely, Demi Marie Obenour (she/her/hers)
OpenPGP_0xB288B55FFF9C22C1.asc
Description: OpenPGP public key
OpenPGP_signature
Description: OpenPGP digital signature
_______________________________________________ devel mailing list -- devel@lists.fedoraproject.org To unsubscribe send an email to devel-le...@lists.fedoraproject.org Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/ List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org Do not reply to spam, report it: https://pagure.io/fedora-infrastructure/new_issue
