[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [legalruleml] [Repository for the examples]
I would prefer not to use the tag mechanism for approved examples because, like issues that are re-opened after they were apparently resolved, I imagine that the "approved" examples will also have to evolve, just less frequently than the draft examples.
I look at example-approval more like a signal - when an example is moved to the approved directory, then it is time for me to work on the schema for it. If an example in the approved directory is changed, then the schemas may need to be updated. So the examples in the approved directory should not be changed unless there is a TC decision to do so.
As to XML coding conventions - I use an XML editor (oXygen) that allows me to pretty-print so I don't care about indenting and so on. In fact, I would prefer that there be no convention about indenting or line breaks.
Other than that, I don't know what conventions we will need. I think we will find out as we go along.
Let's keep track of whatever conventions we develop in a README file at the top of the trunk.
On 7/12/2012 9:53 AM, Guido Governatori wrote:
Hi Tara, On 12/07/2012, at 7:58 PM, Tara Athan wrote:I would like to propose a repository structure as follows: (following http://svn.apache.org/repos/asf/subversion/trunk/doc/user/svn-best-practices.html) 1. it is conventional to have a top level of lrm |_branches |_tags |_trunk where "trunk, meaning the directory under which the main project development occurs; branches, which is a directory in which to create various named branches of the main development line; tags, which is a directory of branches that are created, and perhaps destroyed, but never changed."tags is often used for releases, so it might be appropriate for approved versions.2. under "trunk" (and consequently under each branch or tag) I propose lrm |_examples |_draft |_approved |_sources |_schemas |_relaxng |_modules |_xsd |_modules |_schematron |_modules |_xslt I suggest having separate directories for draft and approved examples so that we can develop, and keep a record of, alternate syntax proposals. However, the schemas will only be required to validate the examples in the "approved" directory. I also suggest that source examples (in xml, pdf, jpg, doc, etc) be kept in a parallel directory "sources", and that each of the directories draft, approved, sources, have a flat structure (no subdirectories). One reason is that it makes it easier for me to validate during schema development if I can point to the directory "approved" and know that it contains only the .lrml examples at the top level. Also, the same source could be used by several examples.Do you also want to set us some coding conventions for XML files. All the best GuidoTara On 7/10/2012 4:42 PM, monica.palmirani wrote:Dear all, as suggested by Harold it is a very good idea to have a versioning system for a library of LegalRuleML XML examples. Please take a look to the following pages where you can find the SVN tool provided by OASIS in order to discuss the issue tomorrow: https://tools.oasis-open.org/ https://tools.oasis-open.org/version-control/browse/ Yours, Monica -- =================================== Associate professor of Legal Informatics School of Law Alma Mater Studiorum Università di Bologna C.I.R.S.F.I.D. http://www.cirsfid.unibo.it/ Palazzo Dal Monte Gaudenzi - Via Galliera, 3 I - 40121 BOLOGNA (ITALY) Tel +39 051 277217 Fax +39 051 260782 E-mail monica.palmirani@unibo.it ==================================== LA RICERCA C’È E SI VEDE: 5 per mille all'Università di Bologna - C.F.: 80007010376 http://www.unibo.it/5permille Questa informativa è inserita in automatico dal sistema al fine esclusivo della realizzazione dei fini istituzionali dell’ente. --------------------------------------------------------------------- To unsubscribe, e-mail: legalruleml-unsubscribe@lists.oasis-open.org For additional commands, e-mail: legalruleml-help@lists.oasis-open.org--------------------------------------------------------------------- To unsubscribe, e-mail: legalruleml-unsubscribe@lists.oasis-open.org For additional commands, e-mail: legalruleml-help@lists.oasis-open.orgAll the best Guido -- Prof Guido Governatori Associate Education Director and Principal Researcher Queensland Research Laboratory NICTA | PO Box 6020 | St Lucia QLD 4067 T +61 7 33008523 | M +61 (0)400 934 738 | F +61 7 3300 8420 www.nicta.com.au | guido.governatori@nicta.com.au The information in this e-mail may be confidential and subject to legal professional privilege and/or copyright. National ICT Australia Limited accepts no liability for any damage caused by this email or its attachments. --------------------------------------------------------------------- To unsubscribe, e-mail: legalruleml-unsubscribe@lists.oasis-open.org For additional commands, e-mail: legalruleml-help@lists.oasis-open.org
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]