On 9/2/24 4:18 PM, Vít Ondruch wrote:
Today, I had a discussion with Mikolaj Izdebsky, maintainer of various
Java pacakges including Ant / Maven. At the beginning, he mentioned
possible license issues he is dealing with in -javadoc subpackages,
then he mentioned bundled jQuery, etc. All these issues are very
familiar to me with the rubygem-*-doc subpackages.
During the brainstorming, one of the proposed solutions was dropping
the doc subpackages altogether. And I wonder, does anybody have use
case for the -doc subpackages. I used to use RI, but I have not used
it for ages. Is the RDoc HTML documentation useful for anybody? I
personally always use online documentation, so I would not necessarily
miss those. But does anybody else use it?
I think RI might be used by some dev-tools like LSP libraries for
editors, maybe even IRB? Not sure, I haven't seen/searched the use-cases
for RI in some time nor have I used an RPM package for that use-case.
One use we have for -doc subpackages in packaging IIRC, and where
dropping them altogether might hurt us for a brief period,
would be files like Rakefile, test suites, README, other .md files, etc.
that are sometimes put into -doc subpackages
to keep the main package thin. That is if such files/directories aren't
%exclude(d).
But to return to the question of HTML docs. We can just not ship the
HTML docs, that'd be fine with me.
Regards,
Jarek
This is more just to measure the sentiment, than that I would plan any
action. OTOH, I would not mind if I would not need to close my eyes
because of the unresolved bundling / licensing issues.
Thanks.
Vít
--
_______________________________________________
ruby-sig mailing list -- ruby-sig@lists.fedoraproject.org
To unsubscribe send an email to ruby-sig-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/ruby-sig@lists.fedoraproject.org
Do not reply to spam, report it:
https://pagure.io/fedora-infrastructure/new_issue
