AETHER-2011 (part1)

Add basic 1.5 release documentation framework

Update edge deployment docs

- Describe different topologies and add deployment diagrams
- Split out Pronto BOM and diagrams
- Make BESS diagram a SVG

Updates to Sphinx and modules, fixed linkcheck to have a timeout/retry
for faulty webservers.

Fix spelling and formatting issue across entire site, remove "Smart
quotes" that cause the spellchecker to throw errors. Add many more
dictionary entries. Make spelling fail the build.  Fix all spelling and
grammar errors that triggered failures.

Add autosectionlabel, and manage duplicate section names where they
existed.

Updated readme on image/diagram embedding

Added docs on PoE power cycle with Aruba switches (Pronto)

Change-Id: I7f9f7afae13788f9fe29bfe2683a295ba7b8914e
diff --git a/Makefile b/Makefile
index c9aabcc..2b41867 100644
--- a/Makefile
+++ b/Makefile
@@ -4,7 +4,7 @@
 SHELL = bash -e -o pipefail
 
 # You can set these variables from the command line.
-SPHINXOPTS   ?=
+SPHINXOPTS   ?= -W
 SPHINXBUILD  ?= sphinx-build
 SOURCEDIR    ?= .
 BUILDDIR     ?= _build
@@ -31,7 +31,7 @@
   sphinx-reload $(SOURCEDIR)
 
 # lint and link verification. linkcheck is part of sphinx
-test: lint linkcheck spelling
+test: lint spelling linkcheck
 
 lint: doc8