updated documentation to better reflect reality