updated documentation (yes, you read that right...)