adjust docs to match reality