I think the user documentation (docs.jquery.com/UI) 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?