adapted the docs to represent current state.