many more doc updates, including Python examples up front