you should document whether they are optional or required, and what the default values are if they are optional.

And the mapping reference needs to be updated (linking to this page for details)