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/ui/hydra/README.org

@@ -1,31 +1,63 @@
-#+TITLE:   ui/hydra
-#+DATE:    october 29, 2019
-#+SINCE:   2.0
-#+STARTUP: inlineimages
+# -*- mode: doom-docs-org -*-
+#+title:    :ui hydra
+#+subtitle: Discount modality for mythological beast hunters
+#+created:  October 29, 2019
+#+since:    2.0.0
 
-* Table of Contents :TOC_3:noexport:
-- [[#description][Description]]
-  - [[#module-flags][Module Flags]]
-  - [[#plugins][Plugins]]
-- [[#prerequisites][Prerequisites]]
-- [[#configuration][Configuration]]
+#+begin_quote
+ 🚧 *This module is deprecated.* The module is too trivially small, and it's
+    always been unclear how hydra fits into Doom's vision for its UI. It's been
+    decided that Doom will head toward Embark, transient, or hercules instead.
+#+end_quote
 
-* Description
+* Description :unfold:
 This module adds hydra to Doom Emacs, as well as a few custom built hydras to
-start with :
+start with:
 
-+ A hydra to control windows ~+hydra/window-nav/body~
-+ A hydra to control text zoom level ~+hydra/text-zoom/body~
+- A hydra to control windows ~+hydra/window-nav/body~.
+- A hydra to control text zoom level ~+hydra/text-zoom/body~.
 
-** Module Flags
-This module provides no flags.
+** Maintainers
+/This module has no dedicated maintainers./ [[doom-contrib-maintainer:][Become a maintainer?]]
 
-** Plugins
-+ [[https://github.com/abo-abo/hydra][hydra]]
+** Module flags
+/This module has no flags./
 
-* Prerequisites
-This module has no prerequisites.
+** Packages
+- [[doom-package:][hydra]]
+
+** Hacks
+/No hacks documented for 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 has no external requirements./
+
+* 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
 Configuring this module is only setting bindings to the provided hydra, or
-creating your own ones !
+creating your own ones!
+
+* Troubleshooting
+/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