You should document your schema before you release it.

Document the following:

• The target namespace with one annotation for the schema.

• Each element with one annotation.

• Each type with one annotation.

• For simple type enumerations, document each enumeration value.

Make sure you describe the use patterns, intended use of types, meanings, optionality, etc.