It's often useful to provide global docs for an entire section of the navigation. I don't know the best yml representation, but it would be replacing something like this:
groups:
'Plugin: Animate':
animate: 'Getting Started'
animate-times: 'Timing'
animate-ease: 'Easing'
'Plugin: Color':
color: 'Getting Started'
color-api: 'Colors'
color-contrast: 'Contrast'
It's often useful to provide global docs for an entire section of the navigation. I don't know the best yml representation, but it would be replacing something like this: