Issue 8710: Discrepancies in Glossary section                                                                                                                                                                       (snp-ftf)
Source: Japan Biological Informatics Consortium (Mr. Martin Senger, martin.senger@gmail.com)
Nature: Uncategorized Issue
Severity: 
Summary: 3. I like the way the Glossary is usually consistent with the model
and the XSD.  There are some discrepancies though.


Discussion:


The definitions of terms are already in section 3.2.  Therefore there
is no need to repeat them again in a separate section called
"Glossary". Having them in one place will guarantee consistency.


Proposed solution:


Replace the complete chapter "Glossary" by text: "The used terms are
defined in section "Model classes, attributes and associations
(details)".


Remove the third paragraph ("Conveniently, most of the used
domain-specific terms are also collected in the Glossary section of
this document.") from the beginning of the Section 3.

Resolution: 
Revised Text: 
Actions taken:
April 26, 2005: received issue
November 1, 2005: closed issue
Discussion: 
Discussion:

The definitions of terms are already in section 3.2.  Therefore there is no need to repeat them again in a separate section called "Glossary". Having them in one place will guarantee consistency.

The glossary can easily (because it is generated) be added as a convenient document as an accompanied file.
	
Resolution:
·	Replace the complete contents of the chapter "Glossary" by text: "The used terms are defined in section "Model classes, attributes, and associations (details)."
·	Remove the third paragraph ("Conveniently, most of the used domain-specific terms are also collected in the Glossary section of this document.") from the beginning of Section 3.



Disposition:	Resolved

End of Annotations:=====
 like the way the Glossary is usually consistent with the model
and the XSD.  There are some discrepancies though.


Discussion:


The definitions of terms are already in section 3.2.  Therefore there
is no need to repeat them again in a separate section called
"Glossary". Having them in one place will guarantee consistency.


Proposed solution:


Replace the complete chapter "Glossary" by text: "The used terms are
defined in section "Model classes, attributes and associations
(details)".


Remove the third paragraph ("Conveniently, most of the used
domain-specific terms are also collected in the Glossary section of
this document.") from the beginning of the Section 3.