Enable nitpicky Sphinx warnings, fix issues and fail on new issues

docs/conf.py

@@ -125,7 +125,7 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+html_static_path = []
 
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.
@@ -249,3 +249,8 @@
 
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {'http://docs.python.org/': None}
+
+
+# --- Nitpicking options ------------------------------------------------------
+
+nitpicky = True

docs/w3lib.rst

@@ -1,28 +1,28 @@
 w3lib Package
 =============
 
-:mod:`encoding` Module
-----------------------
+:mod:`~w3lib.encoding` Module
+-----------------------------
 
 .. automodule:: w3lib.encoding
     :members:
 
 
-:mod:`html` Module
-------------------
+:mod:`~w3lib.html` Module
+-------------------------
 
 .. automodule:: w3lib.html
     :members:
 
 
-:mod:`http` Module
-------------------
+:mod:`~w3lib.http` Module
+-------------------------
 
 .. automodule:: w3lib.http
     :members:
 
-:mod:`url` Module
------------------
+:mod:`~w3lib.url` Module
+------------------------
 
 .. automodule:: w3lib.url
     :members:

tox.ini

@@ -4,7 +4,7 @@
 # and then run "tox" from this directory.
 
 [tox]
-envlist = py27, pypy, py34, py35, py36, py37, pypy3
+envlist = py27, pypy, py34, py35, py36, py37, pypy3, docs
 
 [testenv]
 deps =
@@ -15,3 +15,15 @@ commands =
         --doctest-modules \
         --cov=w3lib --cov-report=term \
         {posargs:w3lib tests}
+
+[docs]
+changedir = docs
+deps =
+    sphinx
+    sphinx_rtd_theme
+
+[testenv:docs]
+changedir = {[docs]changedir}
+deps = {[docs]deps}
+commands =
+    sphinx-build -W -b html . {envtmpdir}/html