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

@@ -1,34 +1,52 @@
-#+TITLE:   app/calendar
-#+DATE:    January 13, 2018
-#+SINCE:   v2.1
-#+STARTUP: inlineimages
+# -*- mode: doom-docs-org -*-
+#+title:    :app calendar
+#+subtitle: Watch your missed deadlines in real time
+#+created:  January 13, 2018
+#+since:    21.12.0 (#355)
 
-* Table of Contents :TOC:
-- [[#description][Description]]
-  - [[#module-flags][Module Flags]]
-  - [[#packages][Packages]]
-- [[#configuration][Configuration]]
-  - [[#changing-calendar-sources][Changing calendar sources]]
-  - [[#synchronizing-org-and-google-calendar][Synchronizing Org and Google Calendar]]
-
-* Description
+* Description :unfold:
 This module adds a calendar view for Emacs, with org and google calendar sync
 support.
 
-** Module Flags
-This module provides no flags.
+** Maintainers
+/This module has no dedicated maintainers./ [[doom-contrib-maintainer:][Become a maintainer?]]
+
+** Module flags
+/This module has no flags./
 
 ** Packages
-+ [[https://github.com/kiwanami/emacs-calfw][calfw]]
-+ [[https://github.com/kiwanami/emacs-calfw][calfw-org]]
-+ [[https://github.com/kidd/org-gcal.el][org-gcal]]
+- [[doom-package:][calfw]]
+- [[doom-package:][calfw-org]]
+- [[doom-package:][org-gcal]]
+  
+** 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:
+- A Google Calendar account.
+- [[https://github.com/kidd/org-gcal.el#installation][An OAuth client ID]], for syncing said account with [[doom-package:][org-gcal]].
+
+* 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
 ** Changing calendar sources
 By defining your own calendar commands, you can control what sources to pull
 calendar data from:
-
-#+BEGIN_SRC emacs-lisp
+#+begin_src emacs-lisp
 (defun my-open-calendar ()
   (interactive)
   (cfw:open-calendar-buffer
@@ -41,10 +59,21 @@ calendar data from:
     (cfw:ical-create-source "Moon" "~/moon.ics" "Gray")  ; ICS source1
     (cfw:ical-create-source "gcal" "https://..../basic.ics" "IndianRed") ; google calendar ICS
    )))
-#+END_SRC
+#+end_src
 
 The [[https://github.com/kiwanami/emacs-calfw][kiwanami/emacs-calfw]] project readme contains more examples.
 
 ** Synchronizing Org and Google Calendar
 The [[https://github.com/kidd/org-gcal.el][kidd/org-gcal.el]] project README contains more detailed instructions on how
 to link your calendar with Google calendars.
+
+* 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