[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [legalruleml] Re: Some items that need to be fixed in LegalRuleML Core
Monica, thanks for the feedback. Can we get more info on what happened in SVN? I'm having a hard time visualizing what went wrong.Thanks,/chetOn Thu, Nov 17, 2016 at 6:52 PM, monica.palmirani <monica.palmirani@unibo.it> wrote:Noted.
The main problem was originated by the dis-alignment of the SVN folders with the document folders (annexes, zip files).
SVN did not respond correctly to our updating.
With the relative URIs this problem could be reduced using local file system folders in order to check.
However the problem is originated to the fact that SVN and docs.oasis-open.org are not synchronized in the folder organization.
Secondly we (TC) do not have the change to check the HTML pages in pre-view modality before the official final submission in docs.oasis-open.org
I suggest, for the future, to set up a technical environment for permitting the folders organisation synchronized with the docs.oasis-open.org (now we are using dropbox and it is not a canonical tool of OASIS) and to provide to TCs also a pre-view area where to test all the HTML pages, including links, before the official submission to the TAB.
These two features will reduce errors from TC, save TAB time, and also minimize the process of publication.
Many thanks,
Monica
Il 17/11/2016 22:05, Paul Knight ha scritto:
Hi all,
Please note that it is very important for the directory structures to be correct. There are a number of errors in the links in the current document.A good example happens to be the one which Chet noted, in Section 3.2.The link is listed in the document as:
However, in the ZIP file "normative-material-legalruleml-core-spec-wd47.zip", the file structure is different, with different directory names. For the file "lrml-basic.xsd", the actual path in the ZIP file is ../xsd-schema/basic/lrml-basic .xsd.
I noted other places where the file names are corrupted, such as within all three footnotes on page 21, which end with "examples/compactified/ex8-defeasible-compact.lrmlex8-defeas " (Also odd to see three footnotes exactly the same)ible-compact.lrml Also 5.18.1 - the last link has embedded "//" where is should be a single slash - generation//stripe_required_4xsd_module.rnc.
Kind regards,Paul
On Thu, Nov 17, 2016 at 2:26 PM, Chet Ensign <chet.ensign@oasis-open.org> wrote:
Hi Guido, Monica & editors of the LegalRuleML Core Spec,
In preparing the draft for publication, we have run into a few issues that we will need you all to fix. There is no need to go through approval again and we would fix these ourselves if they were not so deeply integrated into the package. Here's what we need:
- There are 139 instances in the document where links are created that start with 'http://docs.oasis-open.org/legalruleml/legalruleml-core-spe '. For example, in section 3.2, there is:c/v1.0/csd01/legalruleml-core- spec-v1.0-csd01/
These are not going to work. For one thing, we won't be publishing /csd01/ but rather going straight to work on /csprd01/. For another, we wouldn't want to use the filename as a directory level (that is .../legalruleml-core-spec-v1.0-csd01/...). We just want to go directly to the next directory level - e.g. .../xsd/...
The most convenient way to handle this is to create these as relative links instead. In other words, make the link to xsd/xsd-basic/lrml-basic.xsd. Paul is looking for some examples of this used in other specs.
- We also note that a number of those links appear in footnotes. Functionally, that should be ok. We do want to point out though that the first 39 or so footnotes are in superscript font and so almost impossible to read. Starting somewhere around footnote 40, they switch to normal text. You may want to fix those first 38 or so.
- In the two zip files, there are multiple directories. For example, in the normative...zip file, there are directories named: xslt, rdfs, relaxng, and xsd-schema. Those will be the tops of your relative links unless you want to put them all in a higher level directory such as .../normative/... or some such. Whatever makes the linking more straightforward in my opinion.
- in xslt/lrml-xml/normalizer/, there is an .htacess file. I don't know if that is just there because it was hidden when preparing the zip file or whether there is some reason for it. However, that's not allowed on the docs.oasis-open.org server.
If you have something you are trying to accomplish there, let's talk. If you didn't mean for it to be there, we will just delete it.
- We noted that the Acknowledgements and Revision History appendices are not numbered and that everything else is labelled Annex.
Is there some reason for this? We realize that Annex may have a special meaning or that it simply may be the convention of the RuleML specs. Could you put the Acknowledgement section after all the Annexes and before the Revision History and we could then simply label those Appendix A and B?
- Also, any reason that we should not publish the editable source version as .docx? Since you are editing in MS Office and not in HTML, we'll need to include the editable source in the cover page material. We'd like to do that as .docx unless you have a reason why we shouldn't.
That's it. Please let us know if you have any questions. You can just make these changes and fixes and send the finished documents to us and we'll proceed from there. No need to go back through the whole approval process.--
/chet
----------------
Chet Ensign
Director of Standards Development and TC Administration
OASIS: Advancing open standards for the information society
http://www.oasis-open.org
Primary: +1 973-996-2298
Mobile: +1 201-341-1393
--
Paul Knight - Tel: +1 781-883-1783
OASIS - Advancing open standards for the information society - Document Process Analyst
Identity Ecosystem Steering Group - Framework Management Office
-- =================================== 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 ============================== ====== --
/chet
----------------
Chet Ensign
Director of Standards Development and TC Administration
OASIS: Advancing open standards for the information society
http://www.oasis-open.org
Primary: +1 973-996-2298
Mobile: +1 201-341-1393
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]