updated documentation to reflect reality