Element and Attribute English Definitions

[caitlin]

Moved from ​http://www.ome-xml.org/ticket/101

1. The schema documentation would be much better and more user friendly if all of the entities were defined in plain language in the documentation.
2. Elements and attributes need to be defined individually, and not just included in the documentation of the top-level elements, because otherwise they do not show up in any auto-generated documentation, like that on the website.
3. I would like to encourage you to use an Aristotelian structure for these definitions, or at least to begin them if they include other comments. These take the structure:
   1. A is a B that Cs, where A, B, and C are all independently defined entities.
   2. Ex: ExcitationWavelength? is the wavelength of the laser light that excites the specimen. Units: nanometers (nm).
   3. I encourage this not just for the sake of consistency in a document created by many hands, but because this is the type of definition required of ontological terms in the OBO Foundry. Prepping these types of definitions will give you a leg up on being ontologically compatible down the line; especially since it is feasible your consortium will contribute imaging terms to the Foundry ontologies.