update documentation on what already works