You should "hide" all the possible choices in the `$gender` value - they make the doc more complex to read. It's ok to leave all those details in the PHPDoc, but here in the README, you should only show `$gender = 'male|female'`