Trying to start working on#6226 to document the new YAML flags, I'm thinking that maybe we should add a third section to the YAML component doc, something like:

YAML component:

• Introduction
• Format
• Advanced Format Using Flags
  • Parser
  • Dumper

Of courses, I could have post it in the corresponding issue but I noticed that actually this doc is missing in previous version (2.7?), since we can already use some (now deprecated) extra parameters inparse() anddump().

Shouldn't we start by documenting these parameters, then fix#6226 by adding depreciations notices?

Thanks.

EDIT

• Detail arguments and object parsing,
• DocumentobjectForMap