Migration test of Quick Docs
Find a file
Bradley G Smith 228c63b9c6 Incorporate review feedback and add troubleshooting section
Incorporates review feedback focused on the cluster initialization
segment.
Adds a troubleshooting section for CrashLoopBackOff errors with CoreDNS.
2024-08-28 15:31:40 -07:00
modules/ROOT Incorporate review feedback and add troubleshooting section 2024-08-28 15:31:40 -07:00
.gitignore chore: update gitignore 2023-11-21 06:37:52 +00:00
antora.yml *.yaml: Minor styling fixes 2022-02-08 18:36:49 +01:00
build.sh Updated tools to docsbuilder, fixed some typos. 2023-08-09 12:52:15 +02:00
docsbuilder.sh Updated tools to docsbuilder, fixed some typos. 2023-08-09 12:52:15 +02:00
LICENSE
nginx.conf Updated tools to docsbuilder, fixed some typos. 2023-08-09 12:52:15 +02:00
preview.sh Updated tools to docsbuilder, fixed some typos. 2023-08-09 12:52:15 +02:00
README.md Update README with definition on Quick Docs 2024-07-24 18:31:17 +00:00
site.yml feat: use new URL for UI bundle 2022-04-13 12:25:13 +01:00

Fedora Quick Docs

This is the content repository for the Fedora Quick Docs.

Quick docs is a collection of short HOW-TO, tutorials and FAQ-style documentation for Fedora users on the official Fedora documentation site that cover commonly used workflows/tools.

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 Fedora Docs Website.

Reviewers needed!

Whether it is broken link, outdated screenshots of graphical user interface, technical and grammatical error in Quick Docs, every little contribution helps Fedora Linux users.

Technical review

Some 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

New content creation and curation

Please refer to the guide from the links below.

How to edit these documents

Documentation in Quick Docs is written in AsciiDoc. It's a simple mostly-plain-text markup language. You may want to look at:

Local preview

This repo includes a script to build, watch 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.

The script uses podman. Please make sure you have podman installed on your system (you can also use Docker, but on Fedora podman is recommended).

Installing dependencies on Fedora

$ sudo dnf install podman inotify-tools

To build, watch and preview the site, run:

$ ./docsbuilder.sh

The result will be available at http://localhost:8080 and automatically regenerated when the repo contents change.