fix documentation to match reality