Add documentation explaining the different cases for required properties, nullable properties, and properties with default values

[corranrogue9]

@dkershaw10 I've replied to your feedback. I'm happy to discuss more offline if that's needed. Please take another look when you get a chance.