Better Dynamic Widget documentation?

This is the first paragraph of the documentation on “Dynamic Widgets”:
DynamicWidgets is a widget that displays matching widgets, based on the corresponding settings of the index and may be altered by a Rule. You can configure the facet merchandising through the corresponding index setting.

Huh? A widget that displays other widgets? This is a pretty confusing sentence if you don’t have the proper context. How about a little background info on what it means to have widgets that load other widgets, and why a person might want to do such a thing?

Likewise…the demo area…where the widget appears in the preview section, but not in the playground area.

I think you guys have some work to do to explain this feature to people. It seems like it will be pretty cool…but documentation is very poor right now. It’s hard to get up to speed quickly with bad docs and wonky examples.