Currently capability has a dynamic "description" which is generated for an instance configuration. This is nice to document what the instance of the capability does, but we need some way to generically provide documentation/description/help information about what type of capability is.
When browsing the list of capabilities to add, there is no way except for the name currently to provide details to the user as to what the capability is, and often the name doesn't really provide enough detail to explain what its for.
CapabilityDescriptor should get description() field (or something) which can return the static multi-line content with rich details about the capability type (ie. not about created instances, like describe(Map) does.