merge: rewrite-docs

I've omitted docs/*.org from this merge, as there is still work left to
do there, but I am pushing the module docs early so folks can benefit
from the new docs sooner.

modules/lang/factor/README.org

@@ -1,43 +1,58 @@
-#+TITLE:   lang/factor
-#+DATE:    December 3, 2019
-#+SINCE:   v3.0.0
-#+STARTUP: inlineimages
+# -*- mode: doom-docs-org -*-
+#+title:    :lang factor
+#+subtitle: ...
+#+created:  December 03, 2019
+#+since:    21.12.0 (#2129)
 
-* Table of Contents :TOC_3:noexport:
-- [[#description][Description]]
-  - [[#module-flags][Module Flags]]
-  - [[#plugins][Plugins]]
-  - [[#hacks][Hacks]]
-- [[#prerequisites][Prerequisites]]
-- [[#configuration][Configuration]]
-- [[#troubleshooting][Troubleshooting]]
-
-* Description
+* Description :unfold:
 This module adds support to the [[https://github.com/factor/factor][factor]] programming language and its associated
-_fuel_ emacs plugin.
+[[doom-package:][fuel]] emacs plugin.
 
-+ If possible, include a brief list of feature highlights here
-+ Like code completion, syntax checking or available snippets
-+ Include links to packages & external things where possible
+** Maintainers
+/This module has no dedicated maintainers./ [[doom-contrib-maintainer:][Become a maintainer?]]
 
-** Module Flags
-This module provides no flags.
+** Module flags
+/This module has no flags./
 
-** Plugins
-{A list of linked plugins}
+** Packages
+/This module doesn't install any packages./
 
 ** Hacks
-{A list of internal modifications to included packages}
+/No hacks documented for this module./
 
-* Prerequisites
-You must install [[https://github.com/factor/factor][factor]] to use the advanced functionality of this module.
+** TODO Changelog
+# This section will be machine generated. Don't edit it by hand.
+/This module does not have a changelog yet./
+
+* Installation
+[[id:01cffea4-3329-45e2-a892-95a384ab2338][Enable this module in your ~doom!~ block.]]
+
+This module requires [[https://github.com/factor/factor][factor]] for its advanced functionality.
+
+* TODO Usage
+#+begin_quote
+ 🔨 This module has no usage documentation yet. [[doom-contrib-module:][Write some?]]
+#+end_quote
+
+* TODO Configuration
+#+begin_quote
+ 🔨 /This module's configuration documentation is incomplete./ [[doom-contrib-module:][Complete it?]]
+#+end_quote
 
-* Configuration
 This module requires the installation of factor to be available at
-=fuel-factor-root-dir=. Here's an example of how to set it:
-#+BEGIN_SRC emacs-lisp
+~fuel-factor-root-dir~. E.g.
+#+begin_src emacs-lisp
+;; in $DOOMDIR/config.el
 (setq fuel-factor-root-dir "/Applications/factor")
-#+END_SRC
+#+end_src
 
 * Troubleshooting
-Common issues and their solution, or places to look for help.
+/There are no known problems with this module./ [[doom-report:][Report one?]]
+
+* Frequently asked questions
+/This module has no FAQs yet./ [[doom-suggest-faq:][Ask one?]]
+
+* TODO Appendix
+#+begin_quote
+ 🔨 This module has no appendix yet. [[doom-contrib-module:][Write one?]]
+#+end_quote