Clean-up README

Author: pamolloy

README.md

@@ -10,10 +10,11 @@ sysadmin's main goal is to be a system configuration manager. It accomplishes
 that by providing a typed key value database, on which you the user can create
 "hooks".  These hooks allow you to do one or both of the following things, in
 response to keys or groups of keys changing their values:
-    1) Render jinja2 based templates and save them to the system
-    2) Run arbitrary scripts
 
-For example, say you have a set of keys whose values reflect dhcp settings:
+1. Render jinja2 based templates and save them to the system
+2. Run arbitrary scripts
+
+For example, say you have a set of keys whose values reflect DHCP settings:
 
 ```bash
 network.dhcp.endip = "192.168.99.200"
@@ -25,10 +26,11 @@ network.dhcp.static_assignments = []
 ```
 
 Two hooks exist to service these keys:
-    1) A jinja2 template which renders a [dnsmasq](http://www.thekelleys.org.uk/dnsmasq/doc.html)
-       configuration file which reflects the current values
-    2) A simple redirection script which knows to restart the dnsmasq service
-       via systemd.
+
+1. A jinja2 template which renders a [dnsmasq](http://www.thekelleys.org.uk/dnsmasq/doc.html)
+   configuration file which reflects the current values
+2. A simple redirection script which knows to restart the dnsmasq service
+   via systemd
 
 sysadmin allows you to change the value of one or more of these keys, then
 `commit` them all at once, at which point the 2 hooks above are run. From a
@@ -37,20 +39,20 @@ takes care of the messy, system level details via its hooks.
 
 ## Dependencies
 
-sysadmin's dependencies are codified in its CMakeLists.txt files, but the key
+sysadmin's dependencies are codified in its `CMakeLists.txt` files, but the key
 ones are as follows:
 
-    - decibel-cpp, which is included with sysadmin and built when sysadmin is
-      built. It is a C++ wrapper around libuv, and additional abstractions built
-      with folly
-    - [libuv](https://github.com/libuv/libuv) is a C event loop library
-    - [boost](http://www.boost.org/) is boost
-    - [folly](https://github.com/facebook/folly) is a C++ library, primarily
-      used for its excellent futures code
-    - [protobufs](https://developers.google.com/protocol-buffers/), specifically
-      proto 2, provides the API to sysadmin
-    - [yaml-cpp](https://github.com/jbeder/yaml-cpp) provides YAML config file
-      support
+- decibel-cpp, which is included with sysadmin and built when sysadmin is
+  built. It is a C++ wrapper around libuv, and additional abstractions built
+  with folly
+- [libuv](https://github.com/libuv/libuv) is a C event loop library
+- [boost](http://www.boost.org/) is boost
+- [folly](https://github.com/facebook/folly) is a C++ library, primarily
+  used for its excellent futures code
+- [protobufs](https://developers.google.com/protocol-buffers/) provides the API
+  to sysadmin
+- [yaml-cpp](https://github.com/jbeder/yaml-cpp) provides YAML config file
+  support
 
 ## Systemd Integration
 
@@ -60,8 +62,8 @@ In order to build sysadmin with systemd notify support you need to pass
 `-DSYSADMIN_USE_SD_NOTIFY` during step 3 outlined below. When building sysadmin
 in this configuration `libsystemd` becomes a required dependency.
 
-There is an a systemd service definition which incorporates this functionality
-located [here](configs/prod/sysadmin-notify.service).
+See [sysadmin-notify.service](configs/prod/sysadmin-notify.service) for a
+systemd service definition that incorporates this functionality.
 
 ## Development
 
@@ -76,16 +78,16 @@ make check
 make
 ```
 
-`make check` runs only sysadmin's tests. If you wish to run the decibel-cpp
+`make check` runs only sysadmin's tests. If you wish to run the `decibel-cpp`
 tests, run `make decibel-check`.
 
 ## Dockerized Development
 
-For consistency it's recommended to build and test in Docker.
-We will try an up to date dependency image published to
-[Dockerhub](https://hub.docker.com/r/starryoss/sysadmin-build/).
+For consistency it's recommended to build and test in Docker. We will try to
+keep the dependencies in the image on [Dockerhub](https://hub.docker.com/r/starryoss/sysadmin-build/)
+up to date.
 
-The docker commands are wrapped in the docker_control.sh script.
+The docker commands are wrapped in the `docker_control.sh` script.
 
 ```bash
 # Make sure you have submodules