Redid descriptor prose and example. (Docs not regenerated)
Regenerated docs.