docs(:lang): update READMEs to new format

modules/lang/nix/README.org

@@ -1,57 +1,81 @@
-#+TITLE:   lang/nix
-#+DATE:    May 4, 2020
-#+SINCE:   v2.0.7
-#+STARTUP: inlineimages nofold
+← [[doom-module-index:][Back to module index]]               ↙ [[doom-module-issues:::lang nix][Issues]]  ↖ [[doom-module-source:lang/nix][Source]]  ± [[doom-suggest-edit:][Suggest edits]]  ? [[doom-help-modules:][Help]]
+--------------------------------------------------------------------------------
+#+TITLE:    :lang nix
+#+SUBTITLE: I hereby declare "nix geht mehr!"
+#+CREATED:  December 02, 2017
+#+SINCE:    2.0.8 (#280)
 
-* Table of Contents :TOC_3:noexport:
-- [[#description][Description]]
-  - [[#maintainers][Maintainers]]
-  - [[#module-flags][Module Flags]]
-  - [[#plugins][Plugins]]
-- [[#prerequisites][Prerequisites]]
-- [[#features][Features]]
-  - [[#keybindings][Keybindings]]
-- [[#configuration][Configuration]]
-- [[#troubleshooting][Troubleshooting]]
+* Description :unfold:
+This module adds support for the Nix language to Doom Emacs, along with tools
+for managing [[https://nixos.org/][Nix(OS)]].
 
-* Description
-Adds many tools for [[https://nixos.org/][Nix(OS)]] users in nice package for Doom users.
-
-+ Syntax highlighting
-+ Completion through ~company~ / ~helm~
-+ Nix option lookup
-+ Formatting (~nixfmt~)
+Includes:
+- Syntax highlighting
+- Completion through [[doom-package:][company]] and/or [[doom-package:][helm]]
+- Nix option lookup
+- Formatting (~nixfmt~)
 
 ** Maintainers
-This module has no dedicated maintainers.
+- [[doom-user:][@hlissner]]
 
-** Module Flags
-This module provides no flags.
+[[doom-contrib-maintainer:][Become a maintainer?]]
 
-** Plugins
-+ [[https://github.com/NixOS/nix-mode][nix-mode]]
-+ [[https://github.com/jwiegley/nix-update-el][nix-update]]
+** Module flags
+/This module has no flags./
 
-* Prerequisites
-+ ~nixfmt~ is required to use formatting
-  + If you have Nix(OS) installed it can be installed through Nix configuration ~environment.systemPackages = with pkgs; [ nixfmt ];~ (recommended)
-  + Or through nix-env ~nix-env -iA nixpkgs.nixfmt~
-  + Or through nix-shell ~nix-shell -f https://github.com/serokell/nixfmt/archive/master.tar.gz -i~
-+ ~:editor format~ ~format-all~ also supports ~nixfmt~ so you can use that also to format Nix code, default binding is ~SPC c f~ in evil.
+** Packages
+- [[doom-package:][company-nixos-options]] if [[doom-module:][:completion company]]
+- [[doom-package:][helm-nixos-options]] if [[doom-module:][:completion helm]]
+- [[doom-package:][nix-mode]]
+- [[doom-package:][nix-update]]
+
+** 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./
+
+* TODO Installation
+[[id:01cffea4-3329-45e2-a892-95a384ab2338][Enable this module in your ~doom!~ block.]]
+
+This module requires:
+- [[https://nixos.org/guides/install-nix.html][The Nix package manager]], for a variety of its features (besides syntax
+  highlighting).
+- =nixfmt=, for automatic formatting (requires [[doom-module:][:editor format]]).
+
+- *MacOS:* TODO
+- *Arch Linux:* TODO
+- *NixOS:* in ~pkgs.nixfmt~
+
+* TODO Usage
+#+begin_quote
+ 🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]]
+#+end_quote
 
-* Features
 ** Keybindings
-| Binding           | Description          |
-|-------------------+----------------------|
-| ~<localleader> b~ | ~nix-build~          |
-| ~<localleader> f~ | ~nix-update-fetch~   |
-| ~<localleader> o~ | ~+nix/lookup-option~ |
-| ~<localleader> p~ | ~nix-format-buffer~  |
-| ~<localleader> r~ | ~nix-repl-show~      |
-| ~<localleader> s~ | ~nix-repl-shell~     |
-| ~<localleader> u~ | ~nix-unpack~         |
+| Binding         | Description          |
+|-----------------+----------------------|
+| [[kbd:][<localleader> b]] | ~nix-build~          |
+| [[kbd:][<localleader> f]] | ~nix-update-fetch~   |
+| [[kbd:][<localleader> o]] | ~+nix/lookup-option~ |
+| [[kbd:][<localleader> p]] | ~nix-format-buffer~  |
+| [[kbd:][<localleader> r]] | ~nix-repl-show~      |
+| [[kbd:][<localleader> s]] | ~nix-repl-shell~     |
+| [[kbd:][<localleader> u]] | ~nix-unpack~         |
 
-* Configuration
+* TODO Configuration
+#+begin_quote
+ 🔨 This module has no configuration documentation yet. [[doom-contrib-module:][Write some?]]
+#+end_quote
 
 * Troubleshooting
-+ There aren't any known problems.
+/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