docs(deploying/fedora): Clean up Fedora install docs #1342

Merged
ginger merged 4 commits from julian45/continuwuity:julian/fix-fedora-install-docs into main 2026-02-08 17:25:10 +00:00
Member

This pull request cleans up the Fedora RPM installation documentation in the following manner:

  • Points to the correct location of the repository's GPG key
  • Replaces incorrect information about the GPG key (type, ID) with corrected information
  • Fixes commands for adding repos for each group type
  • Changes incorrect statement about functionality of Fedora RPMs on EL (RHEL, Alma, Rocky, etc.) to caveat with note about ongoing work
  • Removes information about an installation method that appeared to be impossible/nonexistent (direct install of latest RPM in a particular group without adding the group's repo)

Unfortunately, the dnf invocation that Forgejo shows on any given RPM "for RedHat based distributions" does not work on Fedora; it only works on EL. (Which is a reminder to me to put in some work on EL packaging again...)

Fixes: !1240

Tested on a local copy of Fedora 43.

Pull request checklist:

  • This pull request targets the main branch, and the branch is named something other than
    main.
  • I have written an appropriate pull request title and my description is clear.
  • I understand I am responsible for the contents of this pull request.
  • I have followed the contributing guidelines:
<!-- In order to help reviewers know what your pull request does at a glance, you should ensure that 1. Your PR title is a short, single sentence describing what you changed 2. You have described in more detail what you have changed, why you have changed it, what the intended effect is, and why you think this will be beneficial to the project. If you have made any potentially strange/questionable design choices, but didn't feel they'd benefit from code comments, please don't mention them here - after opening your pull request, go to "files changed", and click on the "+" symbol in the line number gutter, and attach comments to the lines that you think would benefit from some clarification. --> This pull request cleans up the Fedora RPM installation documentation in the following manner: - Points to the correct location of the repository's GPG key - Replaces incorrect information about the GPG key (type, ID) with corrected information - Fixes commands for adding repos for each group type - Changes incorrect statement about functionality of Fedora RPMs on EL (RHEL, Alma, Rocky, etc.) to caveat with note about ongoing work - Removes information about an installation method that appeared to be impossible/nonexistent (direct install of latest RPM in a particular group without adding the group's repo) Unfortunately, the `dnf` invocation that Forgejo shows on any given RPM "for RedHat based distributions" does *not* work on Fedora; it only works on EL. (Which is a reminder to me to put in some work on EL packaging again...) Fixes: !1240 Tested on a local copy of Fedora 43. **Pull request checklist:** <!-- You need to complete these before your PR can be considered. If you aren't sure about some, feel free to ask for clarification in #dev:continuwuity.org. --> - [x] This pull request targets the `main` branch, and the branch is named something other than `main`. - [x] I have written an appropriate pull request title and my description is clear. - [x] I understand I am responsible for the contents of this pull request. - I have followed the [contributing guidelines][c1]: - [x] My contribution follows the [code style][c2], if applicable. - [x] I ran [pre-commit checks][c1pc] before opening/drafting this pull request. - [x] I have [tested my contribution][c1t] (or proof-read it for documentation-only changes) myself, if applicable. This includes ensuring code compiles. - [x] My commit messages follow the [commit message format][c1cm] and are descriptive. - [x] I have written a [news fragment][n1] for this PR, if applicable<!--(can be done after hitting open!)-->. <!-- Notes on these requirements: - While not required, we encourage you to sign your commits with GPG or SSH to attest the authenticity of your changes. - While we allow LLM-assisted contributions, we do not appreciate contributions that are low quality, which is typical of machine-generated contributions that have not had a lot of love and care from a human. Please do not open a PR if all you have done is asked ChatGPT to tidy up the codebase with a +-100,000 diff. - In the case of code style violations, reviewers may leave review comments/change requests indicating what the ideal change would look like. For example, a reviewer may suggest you lower a log level, or use `match` instead of `if/else` etc. - In the case of code style violations, pre-commit check failures, minor things like typos/spelling errors, and in some cases commit format violations, reviewers may modify your branch directly, typically by making changes and adding a commit. Particularly in the latter case, a reviewer may rebase your commits to squash "spammy" ones (like "fix", "fix", "actually fix"), and reword commit messages that don't satisfy the format. - Pull requests MUST pass the `Checks` CI workflows to be capable of being merged. This can only be bypassed in exceptional circumstances. If your CI flakes, let us know in matrix:r/dev:continuwuity.org. - Pull requests have to be based on the latest `main` commit before being merged. If the main branch changes while you're making your changes, you should make sure you rebase on main before opening a PR. Your branch will be rebased on main before it is merged if it has fallen behind. - We typically only do fast-forward merges, so your entire commit log will be included. Once in main, it's difficult to get out cleanly, so put on your best dress, smile for the cameras! --> [c1]: https://forgejo.ellis.link/continuwuation/continuwuity/src/branch/main/CONTRIBUTING.md [c2]: https://forgejo.ellis.link/continuwuation/continuwuity/src/branch/main/docs/development/code_style.mdx [c1pc]: https://forgejo.ellis.link/continuwuation/continuwuity/src/branch/main/CONTRIBUTING.md#pre-commit-checks [c1t]: https://forgejo.ellis.link/continuwuation/continuwuity/src/branch/main/CONTRIBUTING.md#running-tests-locally [c1cm]: https://forgejo.ellis.link/continuwuation/continuwuity/src/branch/main/CONTRIBUTING.md#commit-messages [n1]: https://towncrier.readthedocs.io/en/stable/tutorial.html#creating-news-fragments
docs(deploying/fedora): Remove seemingly nonexistent/impossible Fedora install method
Some checks failed
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Pre-commit & Formatting (pull_request) Failing after 3m34s
Checks / Prek / Clippy and Cargo Tests (pull_request) Has been cancelled
4fd5ace7f7
chore: Add news fragment
Some checks failed
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Pre-commit & Formatting (pull_request) Failing after 1m11s
Checks / Prek / Clippy and Cargo Tests (pull_request) Successful in 20m5s
e7f15379a3
ginger self-assigned this 2026-02-08 03:05:36 +00:00
julian45 force-pushed julian/fix-fedora-install-docs from e7f15379a3
Some checks failed
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Pre-commit & Formatting (pull_request) Failing after 1m11s
Checks / Prek / Clippy and Cargo Tests (pull_request) Successful in 20m5s
to 6d9e132444
Some checks failed
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Pre-commit & Formatting (pull_request) Failing after 6m15s
Checks / Prek / Clippy and Cargo Tests (pull_request) Successful in 27m2s
2026-02-08 06:06:15 +00:00
Compare
ginger approved these changes 2026-02-08 16:11:56 +00:00
nex approved these changes 2026-02-08 16:12:49 +00:00
nex added this to the 0.5.4 milestone 2026-02-08 16:15:21 +00:00
fix: Add failing spell check string to typos
All checks were successful
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 3m14s
Checks / Prek / Clippy and Cargo Tests (pull_request) Successful in 12m24s
b70b5b37d9
This isn't the proper fix but whatever it makes CI pass
ginger merged commit 7beeab270e into main 2026-02-08 17:25:10 +00:00
julian45 deleted branch julian/fix-fedora-install-docs 2026-02-08 22:43:05 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
3 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
continuwuation/continuwuity!1342
No description provided.