From 15b90dfb6878a98b841add2e430b32c78090912e Mon Sep 17 00:00:00 2001 From: Justin W. Flory Date: Aug 15 2020 19:47:25 +0000 Subject: prerequisites: Add more reference links for git and AsciiDoc This commit adds an internal link to @bcotton's git for docs writer page, and also adds a link to the AsciiDoc quick reference syntax. It is reasonable to assume someone does not have prior experience with AsciiDoc since it is an uncommon markup language. So, this link provides a practical reference to learn the syntax. (I refer to this page almost every time I write Fedora Docs.) Signed-off-by: Justin W. Flory --- diff --git a/modules/contributing/pages/prerequisites.adoc b/modules/contributing/pages/prerequisites.adoc index 72f9800..d24d6bc 100644 --- a/modules/contributing/pages/prerequisites.adoc +++ b/modules/contributing/pages/prerequisites.adoc @@ -7,9 +7,10 @@ The only requirement for contributing documentation updates to Fedora Docs is: For larger updates or to contribute all-new documentation, you may also need: * A plaintext editor such as [application]`vim`, [application]`emacs`, [application]`Atom`, etc., preferably with ASCIIDoc syntax highlighting. -* [application]`git` and working knowledge of it. -* [application]`Docker` for building and previewing your changes locally. -* A working knowledge of the *ASCIIDoc* markup language. +* [application]`git` (see xref::git.adoc[Git for docs writers]) +* [application]`Docker` or Podman for building and previewing your changes locally. +* Knowledge of *AsciiDoc* markup language (see https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/[AsciiDoc Syntax Quick Reference]) + + [NOTE] ====