It should be possible to add documentation to a schema that represents a vocabulary. Currently it would only be possible to document the individual value terms, complex types, and entity types.
Documentation of an enumeration type and its members would also be helpful.