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

@@ -1,11 +1,51 @@
-#+TITLE: :lang raku
+# -*- mode: doom-docs-org -*-
+#+title:    :lang raku
+#+subtitle: The artist formerly known as perl6
+#+created:  June 05, 2020
+#+since:    21.12.0 (#3308)
 
-This module adds a major mode and flycheck for Raku.
+* Description :unfold:
+This module adds support for the [[https://www.raku.org/][Raku programming language]] to Doom Emacs.
 
-* Table of Contents :TOC:
-- [[#install][Install]]
+** Maintainers
+/This module has no dedicated maintainers./ [[doom-contrib-maintainer:][Become a maintainer?]]
 
-* Install
-This module depends on raku itself.
+** Module flags
+/This module has no flags./
 
-There are no other dependencies.
+** Packages
+- [[doom-package:][raku-mode]]
+- [[doom-package:][flycheck-raku]] if [[doom-module:][:checkers syntax]]
+
+** 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 requires [[https://www.raku.org/][Raku]] for linting and evaluating code.
+
+* TODO Usage
+#+begin_quote
+ 🔨 This module has no usage documentation yet. [[doom-contrib-module:][Write some?]]
+#+end_quote
+
+* TODO Configuration
+#+begin_quote
+ 🔨 This module has no configuration documentation yet. [[doom-contrib-module:][Write some?]]
+#+end_quote
+
+* 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