(From BZ 1789897)
Hi,
I haven't been able to figure out how to navigate to the packaging instructions page [1] from the home page or the docs page [2]. The only packaging-related link from that page is the link to the Packaging Guidelines page [3] which also doesn't have a link to the packaging instructions page.
Could you please add a link somewhere? It would increase usability and probably reduce annoying questions on fedora-devel.
Thanks, -Mat
[1] https://fedoraproject.org/wiki/Join_the_package_collection_maintainers [2] https://docs.fedoraproject.org/en-US/docs/ [3] https://docs.fedoraproject.org/en-US/packaging-guidelines/
This situation is not good at all. Apart from the guidelines, the docs page simply does not have anything at all about how to do packaging. This was quite confusing for me too when I started out some months ago.
There is https://pagure.io/fedora-docs/package-maintainer-docs which looks like it is intended to be published as packaging instructions at docs, but it is two years since anything happened there. See issue 15 there, similar topic that this issue. I tried to ask there if I can help to complete the work, no reply yet. I would like to help, but I do not know what would be a good way to proceed.
I originally misread this as asking for links to the guidelines from other pages, but then I saw that those links have been in place for quite some time. After re-reading, it's not entirely clear to me just what is being requested here, but let me hazard a guess that we could help things out by adding some text like the following in the introductory text:
These documents cover the fine details of acceptable Fedora packaging and while they may include various examples they will not be particularly useful as a tutorial. They also do not cover the details and policies relating to gaining access to the Fedora repositories as a packager, or the mechanics of actually creating and releasing packages as part of the distribution. For documents which cover those issues, please see the following:
Follow that with a link to the Join document and a pointer to at least some landing page where some packaging or package maintenance tutorials are listed. I would like to avoid linking directly to anything which is already outdated and don't want to pretend to maintain an up-to-date list of links to other packaging documents, because history has shown that it will just get embarrassingly outdated.
Metadata Update from @tibbs: - Issue tagged with: meeting
We talked about this at this weeks meeting (https://meetbot-raw.fedoraproject.org/fedora-meeting-1/2021-03-25/fpc.2021-03-25-16.01.txt):
Metadata Update from @tibbs: - Issue untagged with: meeting - Issue assigned to tibbs
Metadata Update from @tibbs: - Issue tagged with: writeup
Commit eeeb7d7 fixes this issue
Login to comment on this ticket.