The following items were broken in [pull request 173][pr]:
* Section was in the wrong level.
* String '<=' was intended to be interpreted as-is, but Antora actually
replaces this sequence with the '⇐' character.
* Delimiters for code blocks were wrong and were interpreted as
horizontal lines.
[pr]: https://pagure.io/fedora-docs/package-maintainer-docs/pull-request/173
Pull requests are an important aspect of how Fedora packaging works,
and, crucially, the easiest way for new contributors to get started.
Document a way how they can be used.
Fixes#66
This adds a procedure how the check the Kerberos authentication works
toward Fedora services. It also links to Koji and Kerberos
documentation at the first occurrence.
A beginner complained that he does not undestand "your_fas_id"
replacement text. That's probably because FAS (Fedora Account System)
is now presnted to users as Fedora Accounts on accounts domain.
This patch updates the wording to be more descriptive. It also
similarly updates a previous command.
Using only local actions, it is difficult to check if a package builds
successfully for all Fedora architectures.
Also, interacting with Koji is an essential skill for Fedora packagers.
For these reasons, a step is added to the GNU Hello packaging tutorial
where a Koji scratch build is performed.
Packagers should use fkinit to acquire a kerberos ticket. It supports
2FA without needing extra configuration, and generally makes sure
everything is configured properly
I don't see a good reason to confuse new packagers with a bunch of debug
output that's likely irrelevant to them. If someone has a problem and
needs more information, they can read the linked wiki page.
Many pages contained instructions for installing packager tooling.
For most parts, the instructions were the same,
but each page did something a bit differently than others.
All of these separate instructions are merged to a single page here.
Each page just links to that one page.