fixes documentation, so we know the code