Contribuire alla Documentazione rapida

The Fedora Docs Team. Version all versions Last review: 2023-08-25
The goal is to move away from wikis, where helpful guides are mixed with draft documentation, internal notes, to a nice, topic-oriented how-to guides and code-packed tutorials with a pull-request-based workflow. We appreciate your help!

Passi

  1. Seleziona un documento da aggiornare. Puoi trovare i documenti che necessitano di un aggiornamento nel file modules/ROOT/nav.adoc. Tali documenti sono commentati (le righe iniziano con //FIXME).

  2. Fai il fork dell’archivio https://pagure.io/fedora-docs/quick-docs.

  3. Effettua le modifiche nel file .adoc da migliorare.

  4. Decommenta il file nel file nav.adoc rimuovendo il prefisso FIXME da xref.

  5. Crea un’anteprima locale per assicurarti che le tue modifiche appaiano come previsto: assicurati di avere installato Podman o Docker. Su un desktop Linux, esegui ./docsbuilder.sh. Su macOS, esegui ./docsbuilder.sh -p o ./preview.sh. Segui le istruzioni stampate nella riga di comando.

  6. Una volta controllate le modifiche, invia una pull request con i miglioramenti.

  7. Se stai migrando una pagina wiki, crea un reindirizzamento verso la vecchia pagina — leggi di seguito.

Possible Source Material

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:

  • The old How To category on the Fedora wiki. Many of those documents are ripe for conversion. (Many are also very out of date!)

  • Common Issues questions on Ask Fedora.

  • Frequent Fedora questions on Stack Exchange.

  • 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.

Reindirizzamenti Wiki

Usually, wikis do not allow redirects to external sites, because the potential for abuse is very high. We’ve developed a plugin for the Fedora Wiki which allows redirects to only pages on this site, https://docs.fedoraproject.org/. To create such a link, use the #fedoradocs macro by putting something like this at the top of the wiki page you are replacing:

{{#fedoradocs: https://docs.fedoraproject.org/en-US/council/fpl/}}

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/.

Una volta che il reindirizzamento è attivo, i visitatori di quella pagina wiki verranno immediatamente trasferiti (reindirizzati, con il codice 301 Moved Permanently) al sito dei documenti.

Notare che non c’è validazione che l’URL di destinazione esista o sia corretto, per cui controllare per bene che ogni reindirizzamento creato funzioni come previsto prima di continuare.

Se hai bisogno di modificare una pagina del genere per correggere l’URL o rimuovere il reindirizzamento per qualche motivo, costruisci un URL del sito wiki con &action=edit, ad esempio:

https://fedoraproject.org/w/index.php?title=Project_Leader&action=edit

Want to help? Learn how to contribute to Fedora Docs ›