Merge pull request #846 from nexusformat/759-nxdl-doc-field

group doc element needs more description
nexusformat · Oct 20, 2020 · 93f1012 · 93f1012
2 parents 49e5514 + 01225bb
commit 93f1012
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/nxdl.xsd b/nxdl.xsd
@@ -499,6 +499,13 @@
 					<xs:documentation>
 						Describe the purpose of this ``group``. 
 						This documentation will go into the manual.
+						The first line should summarize as a complete
+						sentence with no line break. (The automatic
+						documentation will pick just the first line as a
+						summary.) Then a blank line should be added 
+						before any further
+						documentation. Indentation should be consistent
+						with rules for reStructured text.
 					</xs:documentation>
 				</xs:annotation>
 			</xs:element>