Build a local preview to ensure your changes look the way you intended: Make sure you either have *Podman* or *Docker* installed, and run `./build.sh && ./preview.sh`. Follow instructions printed on the command line.
Contribute to Quick Docs
{{#fedoradocs: https://docs.fedoraproject.org/en-US/council/fpl/}}
Fork the https://pagure.io/fedora-docs/quick-docs repo.
Frequent https://unix.stackexchange.com/questions/tagged/fedora?sort=frequent&pageSize=50[Fedora questions on Stack Exchange].
https://ask.fedoraproject.org/c/english/97/l/latest?order=votes[Top-Voted] or https://ask.fedoraproject.org/c/english/97/l/top?order=views&period=yearly[highly-viewed] questions on Ask Fedora.
https://fedoramagazine.org[Fedora Magazine] articles. The magazine format is conversational, and understood to represent a moment in time. Quick Docs versions should be more to-the-point, and kept updated if commands or best pratices change.
If migrating a wiki page, create a redirect on the old page — see below.
If you need to edit such a page to correct the URL, or to remove the redirect for some reason, construct a wiki site URL with `&action=edit`, like: https://fedoraproject.org/w/index.php?title=Project_Leader&action=edit
Make your changes to the `.adoc` file you want to improve.
Note that there is no validation that the target exists or is correct — please double-check that any redirects you create work properly before moving on.
Of course, you should to replace that example URL with the one for your new target page. Again, the URL can't be something arbitrary — it _must_ begin with `https://docs.fedoraproject.org/`.
Once the redirect is in place, visitors to that wiki page will be instantly whisked (well, redirected, with the code `301 Moved Permanently`) to the docs site.
Perhaps you just want to improve an existing document, in which case the above is all you need. Or maybe you already have something in mind. But if you are interested in helping but don't know where to start, here are some places to look for ideas:
Pick a document to update. You can find documents needing updates in the [filename]`modules/ROOT/nav.adoc` file. They are on the commented-out lines (those that start with a `//FIXME`).
Possible Source Material
The goal: move away from exposing users to the wild territory of wikis (where helpful guides are mixed with draft documentation, user pages, rough notes, and so on) to a nice, topic-oriented format with a pull-request-based workflow. We appeciate your help!
The old https://fedoraproject.org/wiki/Category:How_to[How To category] on the Fedora wiki. Many of those documents are ripe for conversion. (Many are also very out of date!)
Uncomment the file in [filename]`nav.adoc` remove the `FIXME` from the xref..