| |
@@ -7,9 +7,10 @@
|
| |
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]
|
| |
====
|
| |
jflory7
commented 3 years ago
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.)