hank-test/quick-docs
1
0
Fork 0
mirror of https://pagure.io/fedora-docs/quick-docs.git synced 2024-11-28 14:56:35 +00:00
Code Issues 1 Projects Releases Packages Wiki Activity Actions
Migration test of Quick Docs
435 commits 1 branch 0 tags 9.9 MiB
Shell 100%
Find a file
Jeffrey Walton 2a01d84d8e Add information on cleaning old symlinks in /usr in dnf-system-upgrade.adoc 
Add information on cleaning old symlinks in /usr in dnf-system-upgrade.adoc.

Fedora includes the symlinks utility, so it is easy to clean the old cruft.
2019-11-21 16:15:45 +00:00
modules/ROOT Add information on cleaning old symlinks in /usr in dnf-system-upgrade.adoc 2019-11-21 16:15:45 +00:00
.gitignore switch to Antora part 2018-07-27 18:53:34 +02:00
antora.yml switch to Antora part 2018-07-27 18:53:34 +02:00
build.sh Update build scripts 2019-03-22 14:37:32 +01:00
LICENSE Add LICENSE 2019-09-17 14:29:46 +02:00
preview.sh Update build scripts 2019-03-22 14:37:32 +01:00
README.md Fix a typo in readme 2019-04-23 10:24:11 +00:00
site.yml switch to Antora part 2018-07-27 18:53:34 +02:00

README.md

Fedora Quick Docs

This is the content repository for the Fedora Quick Docs.

Please report Issues and submit Pull Requests for Content Fixes here. Never done a pull request (or "PR")? Here's the Pagure documentation for Pull Requests.

General appearance issues and publishing issues should be reported against the publishing software.

Reviewers needed!

As discussed in issue #107, a lot of pages in this repository are in need of a technical review. Pages which need one are marked by a disclaimer on the top of the file, right below the top level heading. Any reviews are greatly appreciated. If you want to help, pick one of the pages, check it for accuracy, and then:

  • If you find that all information on the page is correct, either open a pull request which states that you found no problems and which removes the disclaimer from the top (the include::) statement at the top, or open an issue against this repository stating which page you reviewed and found no errors in so we can remove it
  • If you find errors, then either open a pull request fixing them and removing the disclaimer from the top, or open an issue and describe the errors you found, and how to fix them if you know a fix

How to edit these documents

All of this is written in AsciiDoc. It's a simple mostly-plain-text markup language. You may want to look at:

Local preview

This repo includes scripts to build and preview the contents of this repository.

NOTE: Please note that if you reference pages from other repositories, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see the Fedora Docs build repository for instructions.

Both scripts use docker, so please make sure you have it installed on your system. Please see below for instructions.

To build and preview the site, run:

$ ./build.sh && ./preview.sh

The result will be available at http://localhost:8080

Installing docker on Fedora

$ sudo dnf install docker
$ sudo systemctl start docker && sudo systemctl enable docker