Updating docs for v1.0.0b2

- Full cleanup of all the docs
- General sphinx housekeeping
- Updated all the old/bad links
- More reliable tests
- Updated Changelog
- Removed dead/deprecated code
- Added documentation generation test

examples/calculator_client.py

@@ -33,10 +33,7 @@ at the given address and does some RPCs')
 def main(host):
     client = capnp.TwoPartyClient(host)
 
-    # Pass "calculator" to ez_restore (there's also a `restore` function that
-    # takes a struct or AnyPointer as an argument), and then cast the returned
-    # capability to it's proper type. This casting is due to capabilities not
-    # having a reference to their schema
+    # Bootstrap the server capability and cast it to the Calculator interface
     calculator = client.bootstrap().cast_as(calculator_capnp.Calculator)
 
     '''Make a request that just evaluates the literal value 123.