Documentation Proposal: Best Practices for Plugin Markup (Progressive Enhancement)

Documentation Proposal: Best Practices for Plugin Markup (Progressive Enhancement)

I think the user documentation (<a href="http://docs.jquery.com/UI">docs.jquery.com/UI</a>) should include the various types of markup each plugin can accept and describe when and why a user would want to use that style of markup.  For example, if a menu can be created from JSON, a UL element or a SELECT element, we should explain the different scenarios in which it makes sense to use each.  This would essentially be a guide on how to use jQuery UI for progressive enhancement.
Thoughts?