https://bugzilla.redhat.com/show_bug.cgi?id=2359303 --- Comment #3 from Ben Beasley <code@xxxxxxxxxxxxxxxxxx> --- > Comments: > a) Approved Thank you for the review! https://release-monitoring.org/project/377682/ > b) It maybe helpful to package documentation.. I really like the *idea* of packaging useful offline documentation, and for a long time, I went out of my way to build HTML or PDF documentation wherever possible. However, I’ve come to agree with the position that building generated documentation is almost always more trouble than it is worth, and I’ve been actively removing -doc subpackages with documentation generated by Sphinx, Doxygeen, etc. from most of my packages. For HTML, there tend to be issues with bundled fonts, CSS, JavaScript, etc., as noted in bug 2006555. Several recent FESCo decisions have lightened the burden here, but guideline compliance and determining all applicable licenses can still be a burden. Building PDF documentation can help, but tends to be a bit fussy, and TeX is a very heavy build dependency. In this case, there’s at least one missing documentation dependency, which is another reason not to want to try to build the documentation, and except for usage.md, the raw Markdown sources are really not useful by themselves. -- You are receiving this mail because: You are on the CC list for the bug. You are always notified about changes to this product and component https://bugzilla.redhat.com/show_bug.cgi?id=2359303 Report this comment as SPAM: https://bugzilla.redhat.com/enter_bug.cgi?product=Bugzilla&format=report-spam&short_desc=Report%20of%20Bug%202359303%23c3 -- _______________________________________________ package-review mailing list -- package-review@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe send an email to package-review-leave@xxxxxxxxxxxxxxxxxxxxxxx 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/package-review@xxxxxxxxxxxxxxxxxxxxxxx Do not reply to spam, report it: https://pagure.io/fedora-infrastructure/new_issue
