diff --git a/vim-airline-themes/README.md b/vim-airline-themes/README.md
index 74e9727..5418208 100644
--- a/vim-airline-themes/README.md
+++ b/vim-airline-themes/README.md
@@ -2,19 +2,33 @@
 title: vim-airline-themes
 homepage: https://github.com/vim-airline/vim-airline-themes
 tagline: |
-  The official theme repository for vim-airline
+  vim-airline-themes are the 1st-party themes for vim-airline
 ---
 
+To update (replacing the current version) run `webi vim-airline-themes`.
+
+### Files
+
+These are the files / directories that are created and/or modified with this
+install:
+
+```text
+~/.vimrc
+~/.vim/plugins/airline.vim
+~/.vim/pack/plugins/start/vim-airline-themes/
+```
+
 ## Cheat Sheet
 
 > The official themes for vim-airline.
 
-This installer adds the theme selection to `~/.vim/plugins/airline.vim` which is
-created by the vim-airline installer.
+Adds the theme selection to `~/.vim/plugins/airline.vim` \
+(see [vim-airline](../vim-airline/)).
 
-```
+```vim
 let g:airline_theme='simple'
 ```
 
-See the [docs](https://github.com/vim-airline/vim-airline-themes) for a list of
-available themes.
+See
+[github.com/vim-airline/vim-airline-themes](https://github.com/vim-airline/vim-airline-themes)
+for a list of available themes.
diff --git a/vim-airline/README.md b/vim-airline/README.md
index df13d3c..1baf379 100644
--- a/vim-airline/README.md
+++ b/vim-airline/README.md
@@ -2,13 +2,26 @@
 title: vim-airline
 homepage: https://github.com/vim-airline/vim-airline
 tagline: |
-  Lean & mean status/tabline for vim that's light as air.
+  vim-airline: Lean & mean status/tabline for vim that's light as air.
 ---
 
+To update (replacing the current version) run `webi vim-airline`.
+
+### Files
+
+These are the files / directories that are created and/or modified with this
+install:
+
+```text
+~/.vimrc
+~/.vim/plugins/airline.vim
+~/.vim/pack/plugins/start/vim-airline/
+```
+
 ## Cheat Sheet
 
-> Lean & mean status/tabline for vim that's light as air.
+> A single-line status bar for vim.
 
 ![](https://github.com/vim-airline/vim-airline/wiki/screenshots/demo.gif)
 
-See the [vim-airline-themes](/vim-airline-themes) for additional themes.
+See [vim-airline-themes](../vim-airline-themes/) for additional themes.