more work on updating docs

Signed-off-by: Daniel Newns <dan@higgsdesign.com>