diff --git a/README.md b/README.md
index 7e2fd24..36767a6 100644
--- a/README.md
+++ b/README.md
@@ -29,7 +29,7 @@ $ virtualenv dev_env
     ```
 
     - fish/csh:
-    ```sh
+    ```bash
     $ source .dev_env/bin/activate.[fish|csh]
     ```
 
@@ -41,13 +41,12 @@ $ virtualenv dev_env
 ### Generate/Update Documentation
 
 * Make sure `sphinx` is installed:
-```
+```bash
 $ sphinx-[apidoc|build|autogen|quickstart] --version
 $ sphinx-[apidoc|build|autogen|quickstart] 7.2.x
 ```
 
-* Change directory to ./docs and run `make [html|epub|...]`. Generated docs should
-be placed inside `docs/source/[html|epub|...]`.
+* Change directory to ./docs and run `make [html|epub|...]`. Generated docs will appear inside `docs/source/[html|epub|...]`.
 
 #### If you need to generate docs from scratch