quick-docs/en-US/index.adoc

49 lines
1.9 KiB
Text
Raw Normal View History

= Fedora Quick Docs
2017-10-25 21:52:14 +00:00
2017-10-27 21:16:40 +00:00
This repository represents
http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/[asciidoc]
documents roughly (semi-automatically) converted from the top 50
document-like pages in the Fedora Wiki. We want to move away from exposing
users to the wild territory of workspace wikis and to a nice, topic-oriented
format with a PR-based workflow.
2017-10-26 21:37:46 +00:00
So, this is kind of a seed project. *Your help wanted!*
2017-10-26 21:33:16 +00:00
== Steps
2017-10-26 21:33:16 +00:00
2017-10-27 21:16:40 +00:00
1. Pick a document to update.
2. Fork the https://pagure.io/fedora-docs/quick-docs repo.
3. Make your changes to the `.adoc` file you want to improve.
4. Update `_topic_map.yml` to remove "`(FIX ME!)`"
5. Submit a pull request with your improvements.
6. Create a redirect on the old wiki page — see below.
== Wiki Redirects
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 obsoleting:
[source,mediawiki]
----
{{#fedoradocs: https://docs.fedoraproject.org/fedora-project/council/fpl.html}}
----
Of course, you will want to replace that specific URL with the one for your
new target page. 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. If you need to edit such a page to correct the URL, or to remove
the redirect completely, use a form like:
https://fedoraproject.org/w/index.php?title=Project_Leader&action=edit
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.