[ https://issues.apache.org/jira/browse/GERONIMO-2661?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12470808 ]
Matt Hogstrom commented on GERONIMO-2661: ----------------------------------------- Rakesh...looks like you've been quite busy. I'll take a look through the patches and give them a go. Looks good from my quick peek. Thanks! > Make geronimo schema files more human readable > ---------------------------------------------- > > Key: GERONIMO-2661 > URL: https://issues.apache.org/jira/browse/GERONIMO-2661 > Project: Geronimo > Issue Type: Improvement > Security Level: public(Regular issues) > Components: documentation > Affects Versions: 2.0 > Environment: Any > Reporter: Rakesh Midha > Assigned To: Matt Hogstrom > Priority: Minor > Fix For: 2.0 > > Attachments: alldoc.patch, appclientdoc.patch, appdoc.patch, > attributedoc.patch, connectordoc.patch, jettyconfigdoc.patch, jettydoc.patch, > logindoc.patch, moduledoc.patch, namingdoc.patch, plugindoc.patch, > securitydoc.patch, tomcatconfigdoc.patch, tomcatdoc.patch, webdoc.patch > > > Geronimo schema files are the files which are basically exposed to all the > user's to follow the guidelines while developing there plan files. These > schema files should have lot of documentation just like j2ee descriptor's > schema's. All the fields should be described. > Schema formatting provides a nice option to do this by specifying > <xs:annotation> > <xs:documentation lang="en">documentation for each > element goes here</xs:documentation> > </xs:annotation> > for each and every element in schema files. > I think this will make it more human readable, i believe that every file > which is openly exposed to user's should have lot of documentation for > readbility. What do you think? -- This message is automatically generated by JIRA. - You can reply to this email to add a comment to the issue online.