#1055 can't navigate to packaging instructions from fedoraproject.org
Closed: Fixed a year ago by tibbs. Opened a year ago by bcotton.

(From BZ 1789897)


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.


[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

a year ago

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):

  • #1055 can't navigate to pkg instructions from fedoraproject.org
    (geppetto, 16:21:04)
  • ACTION: tibbs to add link to Join document from packaging guidelines
    (geppetto, 16:27:28)

Metadata Update from @tibbs:
- Issue untagged with: meeting
- Issue assigned to tibbs

a year ago

Metadata Update from @tibbs:
- Issue tagged with: writeup

a year ago

Commit eeeb7d7 fixes this issue

Login to comment on this ticket.