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

@@ -1,42 +1,61 @@
-#+TITLE:   emacs/vc
-#+DATE:    May 23, 2020
-#+SINCE:   v3.0.0
-#+STARTUP: inlineimages nofold
+# -*- mode: doom-docs-org -*-
+#+title:    :emacs vc
+#+subtitle: Be the difference you want to see in the fringe
+#+created:  February 20, 2017
+#+since:    2.0.0
 
-* Table of Contents :TOC_3:noexport:
-- [[#description][Description]]
-  - [[#maintainers][Maintainers]]
-  - [[#module-flags][Module Flags]]
-  - [[#plugins][Plugins]]
-- [[#prerequisites][Prerequisites]]
-- [[#features][Features]]
-- [[#configuration][Configuration]]
-- [[#troubleshooting][Troubleshooting]]
-
-* Description
-This module augments Emacs builtin version control support and provides better integration with git
+* Description :unfold:
+This module augments Emacs builtin version control support and provides better
+integration with =git=.
 
 ** Maintainers
-This module has no dedicated maintainers.
+- [[doom-user:][@hlissner]]
 
-** Module Flags
-This module provides no flags.
+[[doom-contrib-maintainer:][Become a maintainer?]]
 
-** Plugins
-# A list of linked plugins
-+ [[https://github.com/rmuslimov/browse-at-remote][browse-at-remote]]
-+ [[https://gitlab.com/pidu/git-timemachine][git-timemachine]]
-+ [[https://github.com/magit/git-modes][gitconfig-mode]]
-+ [[https://github.com/magit/git-modes][gitignore-mode]]
+** Module flags
+/This module has no flags./
 
-* Prerequisites
-This module has no prerequisites.
+** Packages
+- [[doom-package:][browse-at-remote]]
+- [[doom-package:][git-timemachine]]
+- [[doom-package:][gitconfig-mode]]
+- [[doom-package:][gitignore-mode]]
 
-* TODO Features
-# An in-depth list of features, how to use them, and their dependencies.
+** Hacks
+- Allow [[doom-package:][browse-at-remote]] commands in [[doom-package:][git-timemachine]] buffers to open that file
+  in your browser at the visited revision.
+- [[doom-package:][git-timemachine]] buffers will display revision details in the header-line,
+  rather than the minibuffer (easier to see).
+- [[doom-package:][browse-at-remote]] will fall back to the =master= branch if target is in a
+  detached state.
+
+** 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 only requires [[https://git-scm.com/][Git]].
+
+* TODO Usage
+#+begin_quote
+ 🔨 This module has no usage documentation yet. [[doom-contrib-module:][Write some?]]
+#+end_quote
 
 * TODO Configuration
-# How to configure this module, including common problems and how to address them.
+#+begin_quote
+ 🔨 This module has no configuration documentation yet. [[doom-contrib-module:][Write some?]]
+#+end_quote
 
-* TODO Troubleshooting
-# Common issues and their solution, or places to look for help.
+* 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