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/async_calculator_client.py

@@ -70,10 +70,7 @@ async def main(host):
     coroutines = [myreader(client, reader), mywriter(client, writer)]
     asyncio.gather(*coroutines, return_exceptions=True)
 
-    # 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 Calculator interface
     calculator = client.bootstrap().cast_as(calculator_capnp.Calculator)
 
     '''Make a request that just evaluates the literal value 123.

examples/async_ssl_client.py

@@ -11,8 +11,6 @@ import capnp
 import thread_capnp
 
 this_dir = os.path.dirname(os.path.abspath(__file__))
-capnp.remove_event_loop()
-capnp.create_event_loop(threaded=True)
 
 
 def parse_args():

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.