Simplify descriptions of layers

core/templates/README.org.template

@@ -1,7 +1,7 @@
 #+TITLE: %LAYER_NAME% layer
 # Document tags separated with "|" char
-# The example below contains 3 tags: "layers", "my awesome tag", "foo, bar"
-#+TAGS: layers|my awesome tag|foo, bar
+# The example below contains 2 tags: "layer", "web service"
+#+TAGS: layer|web service
 
 # The maximum height of the logo should be 200 pixels.
 [[img/%LAYER_NAME%.png]]

layers/+distributions/spacemacs-docker/README.org

@@ -22,19 +22,6 @@ Spacemacs distribution that aims to automate dependency installation for
 Spacemacs layers and provide well tested Docker based development environment
 with GUI support on all major platforms and even [[https://i.imgur.com/wDLDMZN.gif][your web browser]].
 
-** Screenshots
-[[file:img/MAC_SP.jpg]]
-
-[[https://i.imgur.com/VcuqReF.jpg][HD MacOS image]]
-
-[[file:img/LN_SP.jpg]]
-
-[[https://i.imgur.com/yDok0Q7.jpg][HD GNU/Linux image]]
-
-[[file:img/WIN_SP.jpg]]
-
-[[https://i.imgur.com/WmsnCUo.jpg][HD Windows image]]
-
 ** Features:
 - Automatically get Spacemacs layers dependency installed with [[https://github.com/syl20bnr/spacemacs/blob/develop/layers/%2Bdistributions/spacemacs-docker/deps-install/README.org][installer scripts]]
 - Reap the benefit of Emacs and other GNU/Linux tools on Windows/MacOS machines
@@ -49,6 +36,19 @@ with GUI support on all major platforms and even [[https://i.imgur.com/wDLDMZN.g
 - [[https://github.com/docker/docker/blob/1.13.x/experimental/checkpoint-restore.md][Checkpoint & Restore]] - maybe the fastest way to start a “heavy” environment
 - Friendly for networks with low upload speed/quotas.
 
+* Screenshots
+[[file:img/MAC_SP.jpg]]
+
+[[https://i.imgur.com/VcuqReF.jpg][HD MacOS image]]
+
+[[file:img/LN_SP.jpg]]
+
+[[https://i.imgur.com/yDok0Q7.jpg][HD GNU/Linux image]]
+
+[[file:img/WIN_SP.jpg]]
+
+[[https://i.imgur.com/WmsnCUo.jpg][HD Windows image]]
+
 * How to setup
 The idea is to build your own image [[https://docs.docker.com/engine/reference/builder/#from][FROM]] the one of the provided base images
 ([[https://goo.gl/Rb2Als][spacemacs/emacs25:develop]] and [[https://goo.gl/DFSenZ][spacemacs/emacs-snapshot:develop]]). Get [[https://docs.docker.com/engine/installation][docker]] for the OS of

layers/+emacs/org/README.org

@@ -60,11 +60,11 @@ This layer enables [[http://orgmode.org/][org mode]] for Spacemacs.
 - Insertion of images via [[https://github.com/abo-abo/org-download][org-download]]
 - Project-specific TODOs via [[https://github.com/IvanMalison/org-projectile][org-projectile]]
 
-** BibTeX
+* BibTeX
 For more extensive support of references through BibTeX files, have a look at
 the [[https://github.com/syl20bnr/spacemacs/blob/develop/layers/+lang/bibtex/README.org][BibTeX layer]].
 
-** Important Note
+* Important Note
 Since version 0.104, spacemacs uses the =org= version from the =org= ELPA
 repository instead of the one shipped with emacs. Then, any =org= related code
 should not be loaded before =dotspacemacs/user-config=, otherwise both versions

layers/+lang/latex/README.org

@@ -27,7 +27,7 @@ This layer adds support for LaTeX files with [[https://savannah.gnu.org/projects
 - Tags navigation on ~%~ with [[https://github.com/redguardtoo/evil-matchit][evil-matchit]]
 - Labels, references, citations and index entries management with [[http://www.gnu.org/software/emacs/manual/html_node/reftex/index.html][RefTeX]]
 
-** BibTeX
+* BibTeX
 For more extensive support of BibTeX files than RefTeX provides, have a look at
 the [[https://github.com/syl20bnr/spacemacs/blob/develop/layers/%2Blang/bibtex/README.org][BibTeX layer]].
 

layers/+lang/markdown/README.org

@@ -35,7 +35,7 @@ This layer adds markdown support to Spacemacs.
 - Completion of Emojis using [[https://github.com/dunn/company-emoji][company-emoji]] (still needs a way of showing, either
   using the =emoji= layer or having a proper font) :clap:
 
-** BibTeX
+* BibTeX
 For more extensive support of references with BibTeX files, have a look at the
 [[https://github.com/syl20bnr/spacemacs/blob/develop/layers/%2Blang/bibtex/README.org][BibTeX layer]].
 

layers/+spacemacs/spacemacs-purpose/README.org

@@ -32,7 +32,7 @@ brings popwin’s behavior to window-purpose and solves that problem.
 - Reuses popwin’s settings: =popwin:special-display-config=, =popwin:popup-window-height= and =popwin:popup-window-width=.
 - Difference from popwin: when several windows are open, popup window is sometimes bigger than with regular popwin in the same situation.
 
-** Purposes
+* Purposes
 window-purpose contains a configuration which assigns a purpose for each
 buffer. Later, when Emacs needs to display a buffer in a window, its purpose
 helps make a better decision of which window to use.

layers/+themes/colors/local/nyan-mode/README.org

@@ -22,12 +22,12 @@ point from 0% to 100%.
 - Music, mplayer is needed (M-x nyan-start-music, M-x nyan-stop-music),
 - Customizable properties.
 
-** Fork modifications
+* Fork modifications
 - the starting nyan cat image has no rainbow behind it,
 - the starting rainbow image has zigzags,
 - the animation loop is not endless and occurs only when nyan cat moves.
 
-** Introduction
+* Introduction
 *WARNING, MIND DUMBING CONTENT INSIDE.*
 
 “Nyan-mode. It’s things like this that make me proud to be an emacs user.” - [[http://twitter.com/#!/mitchellh/status/104931263479156736][mitchellh]]

layers/+tools/dap/README.org

@@ -17,11 +17,6 @@ Experimental integrated visual debugger using [[https://code.visualstudio.com/do
 Debug Server. It similar to the [[https://github.com/Microsoft/language-server-protocol][LSP]] but providers integration with debug
 server.
 
-** Layer installation
-To use this configuration layer, add it to your =~/.spacemacs=. You will need to
-add =dap= to the existing =dotspacemacs-configuration-layers= list in this
-file.
-
 ** Features:
 Fully featured IDE-like debugger providing:
 - Launch/Attach
@@ -36,6 +31,11 @@ Fully featured IDE-like debugger providing:
 - Debug/Run configurations
 - Debug REPL
 
+* Layer installation
+To use this configuration layer, add it to your =~/.spacemacs=. You will need to
+add =dap= to the existing =dotspacemacs-configuration-layers= list in this
+file.
+
 * Configuration
 ** Derived layers
 Derived layer should provide information how to configure the language

layers/+web-services/search-engine/README.org

@@ -16,7 +16,7 @@ This layer adds support for the [[https://github.com/hrs/engine-mode][Search Eng
 ** Features:
 - Browser search integration
 
-** Supported search engines
+* Supported search engines
 - Amazon
 - Bing
 - Duck Duck Go