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/checkers/grammar/README.org

@@ -1,68 +1,76 @@
-#+TITLE:   checkers/grammar
-#+DATE:    January 9, 2020
-#+SINCE:   v3.0.0
-#+STARTUP: inlineimages nofold
+# -*- mode: doom-docs-org -*-
+#+title:    :checkers grammar
+#+subtitle: Tasing grammar mistake every you make
+#+created:  January 09, 2020
+#+since:    21.12.0
 
-* Table of Contents :TOC_3:noexport:
-- [[#description][Description]]
-  - [[#maintainers][Maintainers]]
-  - [[#module-flags][Module Flags]]
-  - [[#plugins][Plugins]]
-- [[#prerequisites][Prerequisites]]
-- [[#features][Features]]
-  - [[#language-tool][Language Tool]]
-    - [[#commands][Commands]]
-  - [[#writegood-mode][writegood-mode]]
-- [[#configuration][Configuration]]
-- [[#troubleshooting][Troubleshooting]]
-
-* Description
+* Description :unfold:
 This module adds grammar checking to Emacs to aid your writing by combining
-=lang-tool= and =writegood-mode=.
+[[doom-package:][lang-tool]] and [[doom-package:][writegood-mode]].
 
 ** Maintainers
-This module has no dedicated 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
-+ [[https://github.com/mhayashi1120/Emacs-langtool][langtool]]
-+ [[https://github.com/bnbeckwith/writegood-mode][writegood-mode]]
+** Packages
+- [[doom-package:][langtool]]
+- [[doom-package:][writegood-mode]]
 
-* Prerequisites
-This module requires langtool (which requires =Java 1.8+=).
+** Hacks
+/No hacks documented for this module./
 
-It can be acquired either from https://languagetool.org/ or your OS's package
-manager:
+** TODO Changelog
+# This section will be machine generated. Don't edit it by hand.
+/This module does not have a changelog yet./
 
-+ macOS: ~brew install languagetool~
-+ Arch Linux: ~pacman -S languagetool~
+* Installation
+[[id:01cffea4-3329-45e2-a892-95a384ab2338][Enable this module in your ~doom!~ block.]]
 
-This module tries to guess the location of languagetool-commandline.jar. If you
-get a warning that Doom =couldn't find languagetool-commandline.jar=, you will
-need to set ~langtool-language-tool-jar~ to its location.
+This module requires [[https://languagetool.org/][LanguageTool]] (which requires =Java 1.8+=).
 
-* Features
-An in-depth list of features, how to use them, and their dependencies.
+It is available from either https://languagetool.org/ or your OS's package
+manager. E.g.
+- macOS: ~$ brew install languagetool~
+- Arch Linux: ~$ pacman -S languagetool~
+
+This module tries to guess the location of =languagetool-commandline.jar=. If
+you get a warning that Doom ~couldn't find languagetool-commandline.jar~, you
+will need to set ~langtool-language-tool-jar~ to its location.
+
+* TODO Usage
+#+begin_quote
+ 🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]]
+#+end_quote
 
 ** Language Tool
 [[https://www.languagetool.org/][Language Tool]] is a polyglot proofreader service that checks for grammar and
 stylistic issues in your writing. This requires Java 1.8+.
 
 #+begin_quote
-This requires Java 1.8+
+ 🚧 This requires Java 1.8+
 #+end_quote
 
 *** Commands
-- ~langtool-check~
-- ~langtool-correct-buffer~
+- ~M-x langtool-check~
+- ~M-x langtool-correct-buffer~
 
 ** writegood-mode
 This minor mode highlights weasel words, duplication and passive voice.
 
-* Configuration
-How to configure this module, including common problems and how to address them.
+* TODO Configuration
+#+begin_quote
+ 🔨 This module has no configuration documentation yet. [[doom-contrib-module:][Write some?]]
+#+end_quote
 
 * 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