I wouldn't assume people know these fields, some are not obvious.

Sorry, I don't understand how to document the whole block and what style to follow.  Could you point me to an existing example that can guide me?  Ideally I would add the explanations in the syntax map but I don't know the documentation internals well enough to say what's best.