Commit graph

21 commits

Author SHA1 Message Date
Dennis van Raaij
0e503ae3b1 Clarify the need for a Kerberos ticket for uploading source files 2025-04-12 22:40:29 +03:00
fbfce809a7 Installing Packager Tools: Add link to 2FA setup instructions 2025-04-12 15:08:17 +03:00
2be4f859c4 Installing Packager Tools: Remove explicit fedora-review install
`fedora-review` is now Recommended by `fedora-packager` [1], so it will
get automatically installed as a dependency. There is no need to
explicitly mention it any more.

[1]: https://src.fedoraproject.org/rpms/fedora-packager/pull-request/10
2025-01-29 00:08:53 +02:00
fedcef7adf Fix formatting in Installing Packager Tools
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
2024-12-30 23:44:16 +02:00
Hong Xu
675ca1ce51 Explain the consequence of using git index version 2 by default 2024-12-29 21:58:33 +00:00
Hong Xu
af31d3c040 New line for every period 2024-12-29 21:54:20 +00:00
Hong Xu
42abe3ded6 Add an example tool 2024-12-26 08:08:46 +00:00
Hong Xu
f14cb4ab0c Grammar fixes 2024-12-21 21:46:24 +00:00
Hong Xu
d39227d0b8 Document that git index version must be <= 2 2024-12-21 21:43:50 +00:00
52fb85df60 Add Pull Request Guide
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
2024-07-04 22:07:56 +03:00
700784fd87 Installing Packager Tools: Kerberos authentication verification
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.
2023-02-15 08:23:52 +01:00
feef5941da Installing Packager Tools: Update replacement texts
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.
2023-02-14 17:24:12 +01:00
44ac8dfae8 Add Koji scratch build to GNU Hello tutorial
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.
2022-10-10 05:58:28 +00:00
Maxwell G
da7a471564 Fix typo and remove trailing whitespace 2022-07-19 19:43:04 +00:00
Maxwell G
421402caff Further enhance docs re. acquiring a kerberos ticket 2022-07-19 19:43:04 +00:00
Maxwell G
6394cf2901 Use fkinit instead kinit
Packagers should use fkinit to acquire a kerberos ticket. It supports
2FA without needing extra configuration, and generally makes sure
everything is configured properly
2022-07-19 19:43:04 +00:00
Maxwell G
a19d9e21ae Installing tools: Don't use KRB5_TRACE.
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.
2022-07-19 19:43:04 +00:00
f6aa83acfe
feat: remove explicit toc
The UI bundle now includes a toc in the right hand sidebar, so there's
no need to have tocs explicitly at the start of documents.
2022-03-16 15:37:09 +00:00
Otto Urpelainen
093ee5eb34 Fix section levels in Installing Package Tools 2022-02-14 21:32:41 +02:00
Otto Urpelainen
1b7574bba4 Remove mention of .fedora.upn
It seems that no tool needed in package maintenance
actually uses file .fedora.upn.
Thus there is no need to mention it in the tool installation page.
2022-02-11 23:28:03 +02:00
Otto Urpelainen
9ef3b5b958 Deduplicate tool installation instructions
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.
2022-02-11 23:28:03 +02:00