diff --git a/layers/+checkers/spell-checking/README.org b/layers/+checkers/spell-checking/README.org
index 2b60b6e70..f525fed34 100644
--- a/layers/+checkers/spell-checking/README.org
+++ b/layers/+checkers/spell-checking/README.org
@@ -14,14 +14,13 @@
 - [[#known-issues][Known issues]]
 
 * Description
-This layer provides spell checking using [[http://www-sop.inria.fr/members/Manuel.Serrano/flyspell/flyspell.html][Flyspell]] and [[https://github.com/nschum/auto-dictionary-mode][auto-dictionary-mode]].
+This layer provides spell checking capabilities to Spacemacs.
 
 ** Features:
- - Buffer-wide spell checking via external command (ispell, hunspell, aspell)
- - Spell as you type
- - Optional corrections popup controlled with enable-flyspell-auto-completion
-   variable.
- - Auto dictionary mode for some languages.
+- Buffer-wide spell checking via external command (ispell, hunspell, aspell) run through [[http://www-sop.inria.fr/members/Manuel.Serrano/flyspell/flyspell.html][Flyspell]].
+- Spell as you type
+- Optional correction popups, controlled by =enable-flyspell-auto-completion= variable.
+- [[https://github.com/nschum/auto-dictionary-mode][Auto dictionary mode]] for some languages.
 
 * Install
 ** Layer
diff --git a/layers/+tools/ansible/README.org b/layers/+tools/ansible/README.org
index 5bce5a146..35f478ed1 100644
--- a/layers/+tools/ansible/README.org
+++ b/layers/+tools/ansible/README.org
@@ -4,6 +4,7 @@
 
 * Table of Contents                                         :TOC_4_gh:noexport:
 - [[#description][Description]]
+  - [[#features][Features:]]
 - [[#install][Install]]
 - [[#configuration][Configuration]]
   - [[#ansible-vault][ansible-vault]]
@@ -12,7 +13,12 @@
 - [[#key-bindings][Key bindings]]
 
 * Description
-This layer adds support for Ansible-flavored YAML buffers and Jinja2 templates.
+This layer adds support for editing Ansible configuration files in Spacemacs.
+
+** Features:
+- Syntax highlighting for Ansible-flavored YAML and Jinja2 templates.
+- Auto-completion via =company-ansible=.
+- Integration of =ansible-vault= into emacs for automatic encryption/decryption of files.
 
 * Install
 To use this configuration layer, add it to your =~/.spacemacs=. You will need to