OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

legaldocml message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [legaldocml] Public Comments


Dear John,

many thanks for your constructive email.

As LegalDocML TC we accept the idea of having a meeting to resolve the naming convention issue.

We do want to find a good technical solution that makes AKN suitable for both purposes: to have a robust and interoperable standard for all and to provide adequate flexibility for our stakeholders. A standard should be flexible enough to permit great use/customization/extension, but we still believe that some "basic" principles are necessary to avoid the "fragmentation" effect, typical phenomena of open standard and so to lose the interoperability.

We need also to guarantee the interests of other stakeholders (e.g., Africa, South America, North America, civil society, associations, activisms, etc.) and our role is very delicate in this because we have plenty of requests from our OASIS members to accommodate. These "basic" principles are called in OASIS "conformance rules" and are the basic pillars of a standardization process. For this reason it is important that we define precisely what we intend for "functional equivalence". Since ELI does not have "conformance rules", we cannot cite it in our documentation as a reference standard (only in the plain bibliography at the end of the document), while URN:LEX is a standard and we can cite it.

Secondly I need to inform you, and also the ELI group, that several comments that were submitted are not eligible because they impact parts of the documentation that already successfully passed the first public review. Therefore the only comments we agree to open discussion on at the moment are strictly connected to the basic issue of "functionally equivalent IRIs". This resolution, already cleared with the OASIS officials, allows us to preserve our investment in energy, money, and time, and avoids the risk of never-ending loops.

Considering that an official request of the ELI group was sent via the official legaldocml-comment@lists.oasis-open.org mailing list, considering that this generated an interrupt in the standardization process in the second public review (which is usually devoted to refining minor parts), considering that the ELI group decided to use this phase even if some members of the group are OASIS members too, we must manage the resolution within the rules of the OASIS process. In other words it is appropriate that we organize a meeting inside of a LegalDocML official event for us to be able to produce a valid decision.

It would have been rather different if your request had been submitted previously, as a request for information or clarification to the LegalDocML group during the documentation production phase, or a proposal for a different editing of our documents when it was still on-going.

So it happens that we will hold our obligatory annual Face2Face meeting in Ravenna in September. This is a thing we have been doing every year since 2013. It is an official Technical Committee meeting, a requirement from the OASIS rules, and according to the OASIS process the Face2Face meeting is the most appropriate institutional event where issues arising from public comments can be managed. It happens to be aligned with the Akoma Ntoso Summer School, for obvious practical needs, but it is also and fundamentally THE official OASIS event in which we discuss technical things. Several members of the LegalDocML TC will be in Ravenna this year. Organizing a special event in a different date and in a different place, such as moving the whole LegalDocML TC to London, would be very complicated and it would create a further delay to the schedule that LegalDocML TC must deal with, damaging the expectations for many other OASIS members.

For this reason we kindly insist that you, and the others of the ELI group, do the little effort to come to Ravenna any time between September 5 to 13, in order to genuinely tackle our issues while respecting OASIS rules. We will find a solution good for all! We can open a doodle in order to decide together the most suitable date for all of us. Any time between 5 and 13 September is good. Let me know if this option is good for you and the group.

All the best,
Monica and Fabio
ps.
Fabio produces a resolver from ELI to AKN, open source, here (click on the examples buttons): http://akresolver.cs.unibo.it/examples/eli.html
Monica produces web portal and API for CELLAR in order to permit an easy download of all material and in near future the conversion in AKN: http://sinatra.cirsfid.unibo.it/node/formex2akn/
Both of them are good proof-of-concept that we can find a solution good for all and that we are not so far.


Il 05/08/2016 15:16, John Dann ha scritto:

Dear Monica and Fabio,

 

First we think that our positions are not that far away. As Marc suggested, would it be possible to meet with each other (at least OP, John S, John D and maybe others), maybe in September, either in Luxembourg or in Brussels or London (John S is happily inviting us). Unfortunately, as you know for my part Ravenna is not possible, neither for Marc who is already speaking at another conference at the same time.

 

I really think that we can easily find common grounds and have a solution which could not only benefit the ELI TF but a lot more users. Looking at the AKN URI now and comparing them to ELI URIs,

I also copy again UK comments in their email: “We would like to see use of the Akoma Ntoso Naming Convention made optional and the specification modified to allow for any other well-defined URI/IRI scheme to be used to identify and reference documents. We also support the feedback submitted by the Office of Publications of the European Union.

 

BUT having said that, I am a bit puzzled by your comments in your public reply https://lists.oasis-open.org/archives/legaldocml-comment/201608/msg00001.html . I must say reading this, does not sound very promising for any future discussion. I also like to state that Marc’s public comments were distributed to the full ELI task Force, Including UK as you state John S., and to the full hierarchy at OPUE, before sending. I fully support them.

Public comments are meant to be, and are necessary to advance swifter, and comments event though they do not go exactly the way you wanted them must be equally accepted.

 

As you might be aware, Luxembourg has built a fully automated parser to read our documents and convert them automatically into AKN WITH ELI URI. It works quite well and we have already converted a large document sets. Our URIs are stable, easy to reference and persistent even though being ELIs LOL …

 

Just for reminder ELI, even if the name is misleading, is not a standard for EU countries only, and I do not know how to interpret your comment “ - Quindi bene che esista la lobby di ELI, ma che non venisse a dettare legge in OASIS perchè si rivoltano tutti (Americani del Nord e del Sud, Asiatici, Africani insomma i non europei) e noi come chair li stiamo tenendo buoni. Ok?  - Google translate “"Then good, there is the ELI lobby, but it must not dictate laws in OASIS, because everybody will revolt (North and South Americans, Asiatics, Africans, in short all non-Europeans). We as chairpersons have to keep good relations. OK?" is interesting, and I would like to know how “ELI” is doing this, especially that we only commented on the AKN proposal.

 

I still believe, maybe naively, that we can find common ground, and again this is not a criticism on the work done on AKN which is impressive.

 

John

 

 

From: KUSTER Marc (OP) [mailto:Marc.KUSTER@publications.europa.eu]
Sent: Friday, July 29, 2016 11:41 AM
To: 'monica.palmirani' <monica.palmirani@unibo.it>
Cc: 'Fabio Vitali' <fabio@CS.UniBO.IT>; Catherine Tabone <Catherine.Tabone@nationalarchives.gsi.gov.uk>; 'Søren Broberg Nielsen (957sbn)' <Soren.Nielsen@civilstyrelsen.dk>; Patrice Platel <patrice.platel@sgg.pm.gouv.fr>; 'Gerry'' <Gerry_Matthews@ag.irlgov.ie>; Jean-Michel THIVEL <jean-michel.thivel@sgae.gouv.fr>; 'Nina Koch (957nko)' <Nina.Koch@civilstyrelsen.dk>; SCIARRINO Valeria (OP) <Valeria.SCIARRINO@publications.europa.eu>; KOENIG Kurt (OP) <Kurt.KOENIG@publications.europa.eu>; MALAGON Carmen (OP) <Carmen.MALAGON@publications.europa.eu>; SCHMITZ Peter (OP) <Peter.SCHMITZ@publications.europa.eu>; PAPPALARDO Roberto (OP) <Roberto.PAPPALARDO@publications.europa.eu>; KARDAMI Maria (OP) <Maria.KARDAMI@publications.europa.eu>; BAGOLA Holger (OP) <Holger.BAGOLA@publications.europa.eu>; John Dann <John.Dann@scl.etat.lu>; FRANCESCONI Enrico (OP) <Enrico.FRANCESCONI@publications.europa.eu>; 'legaldocml@lists.oasis-open.org' <legaldocml@lists.oasis-open.org>; 'legaldocml-comment@lists.oasis-open.org' <legaldocml-comment@lists.oasis-open.org>; 'Aki Hietanen' <aki.hietanen@om.fi>
Subject: RE: [legaldocml] Public Comments

 

Dear Monica, Flavio,

 

I am surprised. Our objective is to achieve meaningful conformance rules to Akoma Ntoso, identifying in each case the exact action on your side that, if taken, leads to a satisfactory resolution of our comment.

 

Our key concern is that the question of interoperability of the identifiers (= naming convention) must be independent from the question of interoperability of the document structure. Compliance to one must not be a prerequisite for compliance to the other, though anybody who so wishes, can use them in combination. In this sense Akoma Ntoso should just follow the best practice of DocBook, a very successful OASIS standard, Text Encoding Initiative (TEI) and many other document formats.

 

Your proposal does only partially reply to this concern. This is also at the very core of the National Archive's comment that it must not be mandatory to provide a converter from  a functionally equivalent naming convention syntax to the Akoma Ntoso equivalent.

 

From a technical point of view, building an architecture that binds compliance to an XML document structure to the presence and operation of specific technical components (resolver and converter) is the very opposite of a robust design for interoperability. However, compliance to the document structure of Akoma Ntoso _is_ one of our goal. In this sense, the question is not the presence of "one additional element", it is the coupling of two different concerns and dependence on third-party software components. Already from a long-term archiving perspective – a key concern at least for the OP – having formal validity depend on such an external mechanism is a no-go.

 

These comments originate from the ELI Task Force and so focus on the concerns of ELI, but they equally apply to other identification schemes such as URN:LEX or (for case law) ECLI

 

In CEN and ISO we have used comment resolution meetings to come, if possible, to a mutually agreed disposition of comments. Of course, we would be available for such a meeting, is you consider it useful

 

Best regards

 

Marc

 

From: monica.palmirani [mailto:monica.palmirani@unibo.it]
Sent: Tuesday, July 26, 2016 11:59 PM
To: KUSTER Marc (OP)
Cc: 'Fabio Vitali'; Catherine Tabone; 'Søren Broberg Nielsen (957sbn)'; Patrice Platel; 'Gerry''; Jean-Michel THIVEL; 'Nina Koch (957nko)'; ''
aki.hietanen@om.fi'; SCIARRINO Valeria (OP); KOENIG Kurt (OP); MALAGON Carmen (OP); SCHMITZ Peter (OP); PAPPALARDO Roberto (OP); KARDAMI Maria (OP); BAGOLA Holger (OP); 'John.Dann@scl.etat.lu'; FRANCESCONI Enrico (OP); legaldocml@lists.oasis-open.org; legaldocml-comment@lists.oasis-open.org
Subject: Re: [legaldocml] Public Comments

 

Dear Marc, dear ELI group,

 

that was a fairly disappointing answer to our compromise proposal. In fact, we felt it was not even a search of compromise, but a hardening of reciprocal position of distrust. It would be very sorry if that was the case. We would have welcomed counterproposals and discussions, rather than a plain and cold yes/no judgment on individual items. 

 

The proposed compromise was meant exactly to accommodate a number of other naming conventions, including country-specific ELI implementations as well as URN:LEX and others. This was meant that ELI implementations could be used transparently within Akoma Ntoso documents with a modicum of effort (ONE ADDITIONAL ELEMENT, that's all). 

 

This shrill reaction seems to mean that you are not interested in considering the compatibility with Akoma Ntoso, but only in excusing yourself from finding good reason to look carefully into it. 

 

In summary: 

 

Thanks for taking up the idea of the functionally equivalent naming convention. However, currently the ELI naming convention seems to be only partially accommodated but subject to AKN conditions as opposed to being on “an equal footing” and this will need to evolve significantly.

 

We never meant to introduce an equal footing for the ELI naming convention specifically. We aimed at allowing reasonably sophisticated naming conventions different from the native Akoma Ntoso to be used everywhere an URI ref is allowed. Nothing specific for ELI, but we fully expected that most ELI Implementations that we are aware of, including UK, EU, FR, and others, could immediately apply. 

 

 

 

Dear John & John, 
 
during the last LegalDocML TC, on June 29th, the group has analyzed your comments and discussed about a possible way to satisfy both your concerns and our need to preserve the consistency of our overall design of the Akoma Ntoso proposal. 
 
In this message we would like to advance to you, informally, the gist of the solution, and once we receive your approval, proceed to actually draft and emit a new version of the documentation for the formal approval procedure. 
 
Briefly, the most relevant and pivotal comment is on the naming convention and on your request to allow "on an equal footing" other naming conventions than Akoma Ntoso's own one. We understand the request and the underlying need, and we are inclined to accept that as long as we can express a few simple and reasonable requirements. 
 
In brief, we would like to adopt your concept of "functionally equivalent naming convention" (FENC), specify that only FENCs are acceptable in Akoma Ntoso XML documents, and provide a few reasonable indications of what we mean by functional equivalence. 
 
A functionally equivalent naming convention is defined as follows: 
 
 [ELI + OP] Disagree with most of these requirements. Why are they needed? Some of these requirements are highly subjective (when is something "memorizable", "global" etc.)? Who would measure these and decide on the possible compliance as functionally equivalent naming convention?

 

It may be difficult to follow this, but compliance cannot be requested nor enforced. Akoma Ntoso does not have guns, and no institution is emitting licenses allowing one to use Akoma Ntoso if an only if some requirement is followed. 

 

You can use the Akoma Ntoso XML vocabulary and your own naming convention in it and nobody will sue you. 

 

The only thing we can do is to provide a series of guidelines on how to use the language. These guidelines are only meant to guarantee interoperability of tools and datasets. Adopting only part of these guidelines means only that you admit that you do not care very much for interoperability of tools and datasets. Which you are absolutely free to do, but it is not fully compliant with LegalDocML OASIS conformance rules that we intend to provide to the world.

 

Any naming convention that declares itself to be functionally equivalent, is persistent and well publicly documented must qualify. 
 
 
1)  *recognizable*: a syntactical means exists to recognize the specific syntax used for the URI (e.g., a specific prefix); 
[ELI + OP] This would largely be the case for ELI (and ECLI), but why this requirement? Also the /eli/ part is _not_ a mandatory part of the ELI identifier syntax (and the UK doesn't have it…). 

 

No part of ELI is mandatory, not even the eli prefix itself. In fact, we do not look at ELI, which in our mind does not even exist for exactly this reason, but to individual ELI implementations, which usually DO adopt such prefix. In an interoperable world (which is where we would like to exist), recognizing that a URI is, in fact, a UK uri as opposed to a French URI is interesting. This is the reason to require such a syntactical means. 

 

[KUSTER Marc (OPOCE)] This is inbuilt into ELI by the very fact that the hostname of the http-URI will always be specific to a data provider (and, of course, this part _is_ mandatory, as each ELI is a complete http URI)

 

2)  *published*: a sufficiently detailed description of the syntax is publicly available and backed by a recognizable institution; 
[ELI + OP] OK (assuming that "recognizeable institution" = relevant stakeholder). Otherwise, badly defined

 

please provide a better definition. We did not plan to define it at all, we only tried to find a common ground. Simply sying "Not enough, try again" does not help the cooperation.

 

[KUSTER Marc (OPOCE)] Indeed, we did implicitly suggest one: replace "recognizable institution" by "relevant stakeholder"

 

 
3)  *FRBR compliant*: A full distinction between "distinct intellectual creations", "specific intellectual forms", "physical embodiments" and "exemplars" of relevant documents must be explicitly supported and aligned with the FRBR conceptualizations. Support for items is not necessary nor requested. 
[ELI + OP] Why is this relevant at the identifier level? As it is formulated, it is unclear if ELI complies to this or not

 

actually ELI conformance rules do not exist. Many individual ELI implementations, including UK, EU, FR, as far as we are aware of, do comply. 

 

As to the reason for this: FRBR is FUNDAMENTAL everywhere in Akoma Ntoso. It is one of the basic building blocks of Akoma Ntoso. We are NOT going to requiring a good support for FRBR just because within the ELI group you were not able to reach a consensus on its meaning. 

 

[KUSTER Marc (OPOCE)] Leaving aside the question of ELI conformance rules, this does not answer the question why this is relevant _at the identifier level_ (ELI itself is, of course, built on FRBR for the structuring of its metadata). In fact, the question of conformity to the Akoma Ntoso XML vocabulary must be orthogonal from the question of any possible structure, FRBR or otherwise, of an identifier

 

 
4) *CEN Metalex compliant*: the seven rules in CEN Metalex requirements (section 6.1 of [1]) must be fully implemented: 
 "To allow for the discovery of IRI identifiers, names must be:
      1. Persistent: names at all levels must maintain the same form over time regardless of the political,
         archival and technical events happened since their first generation;
 [ELI + OP] OK
 
      2. Global: all relevant documents by all relevant bodies must be represented;
 [ELI + OP] What does this mean? Documents are globally accessible or the scheme is globally applicable? If the last, why? 
What are "all relevant bodies"?

As explicitly specified, we are mentioning a third party document (CEN Metalex, ftp://ftp.cen.eu/CEN/Sectors/List/ICT/CWAs/CWA15710-2010-Metalex2.pdf ) which existed before this naming convention. This document lists in a very generic form a set of requirements for CEN Metalex compliancy. The Akoma Ntoso Naming Convention, in the mind of its proponents, does its best to comply with them. Functional equivalence, in our mind, means exactly that the candidate naming convention must have the same consideration for the CEN Metalex requirements that we had. 

 

The actual answers can and must be found in the CEN Metalex document, if anywhere. Both questions you raise, nonetheless, are easy to answer: 

 

1) The scheme must be globally applicable to all documents to which it claims to apply. Easy. 

2) The relevant bodies are all organizations emitting documents for which the candidate naming convention claims to apply. Also easy. 

 

[KUSTER Marc (OPOCE)] Thanks for clarifying the definitions, they are OK as this (and not at all evident when looking at your previous definition)

 

Please note that the term "global" is defined in Metalex in a quite different sense, namely that "the index of the element is unique within the entire document (e.g. the third table in a (sic!) act"  (3.2.1).

 

 
      3. Memorizable: names should be easy to write down, easy to remember, easy to correct if they were written
         down wrongly;
[ELI + OP] In principle OK, though subjective


Ok. 

 

 

 
      4. Meaningful: names should mean something; It should be possible to make assumption about the kind, freshness
         and relevance of a citation by looking only at the document’s name;
 [ELI + OP] OK (but what does freshness mean)

 

Our take: in  a versioned document, it should be possible to make assumption about the actual version you are interested in. 

 

      5. Guessable across levels: references to different levels of the same document must be similar; e.g., 
         given a reference to an _expression_ a user should be able to deduce the name of the work;
 [ELI + OP] OK
 
      6. Guessable across document classes: references to different instances of the same document type must 
         be similar; and
 [ELI + OP] OK
 
      7. Guessable across document components: references to different components of the same document at the 
         same level must be similar."
 [ELI + OP] OK
 
4)  *active*: at least one working, accessible, available, robust resolver must exist that provides dereferencing of URIs/IRIs according to the specific syntax;
 [ELI + OP] No resolver must be required, unless this includes is the general http resolution mechanism

 

IF the resolution of your identifier can happen through the general http resolution, THEN you automatically comply. This is NOT the case for ALL candidate naming convention, so we felt the need to add this requirement. 

 

[KUSTER Marc (OPOCE)] If clarified in this sense, then OK. In this case please add the following clarification after "syntax": "Dereferenceable http URIs are automatically considered to comply to this requirement."

 

 
5)  *equivalent*: at least one working, accessible, available, robust converter must exist that converts URIs/IRIs according to the specific syntax into equivalent URIs/IRIs according to the Akoma Ntoso Naming convention; 
[ELI + OP] In this case the Akoma Ntoso Naming convention is the privileged partner and not a choice on "an equal footing". 
In practical terms, who would maintain such a converter?

 

Being an Akoma Ntoso document means BOTH using the Akoma Ntoso XML vocabulary AND being part of a network of document collections that talk to each other. This is probably NOT a requirement for ELI, but it is one for Akoma Ntoso. 

 

Interoperability, thus, means that a resolver should be able to resolve URIs regardless of the naming convention used, and in particular source documents using internally a naming convention which is different than the one used by the document base where the destination document is stored should be able to access the destination document anyway. 

 

The opposite, i.e., requiring that the author of the source document KNOWS which naming convention is used in the destination document collection, hardly seems robust and interoperable. 

[KUSTER Marc (OPOCE)] Disagree for the reasons mentioned above

 

6)  *evident*: Akoma Ntoso XML documents identifying themselves (in <FRBRUri> and <FRBRThis> elements) using a FENC URI, must also provide equivalent <FRBRalias> elements with the URI ref corresponding to <FRBRThis> according to the Akoma Ntoso Naming Convention, one for each of the first three FRBR levels. 
[ELI + OP] Unacceptable. As an effect of this everybody would have to support the Akoma Ntoso naming convention in any case, the only difference being that in this case ELI is the primary schema and Akoma Ntoso the obligatory second one. In this, the Akoma Ntoso naming convention retains a privileged position and is not at all "on an equal footing"

 

Equal footing, in our mind, does not mean ignoring each other. It means actively looking for a compromise situation where the syntax may differ, but the functionalities stay the same. Interoperability is the MOST IMPORTANT functional requirement for being part of the Akoma Ntoso world. You cannot have interoperability if you do not allow resolver to access documents using a different naming convention that the source document uses. This is the only justification for this requirement. 

 

In practice, this requires that ONE element per FRBR level (THREE element total) are added to an Akoma Ntoso XML document to be compliant with this requirement. All links, all components, all references, all annotations

 

As said, you can use Akoma Ntoso XML documents with no legal consequences. Nonetheless, if you want OUR resolvers to access your documents, you must allow them to discover the Akoma Ntoso equivalent URIs. 

[KUSTER Marc (OPOCE)] Equal footing does mean that you can use any one identifier system without necessarily being aware of the other ones

 

Any Naming Convention that complies with these requirements is termed a *functionally-equivalent Naming Convention* and its URIs can be used in any situation where Akoma Ntoso URIs/IRIs are appropriate. 
 
Finally we resist at allowing custom syntaxes for inner-document ids in eId and wId, because 
a) inner document identifiers are a reflection of the overall XML structure, which is still Akoma Ntoso, and not of the document-level URI syntax adopted, 
b) allowing multiple syntaxes for the same attributes would create havocs in any decent resolver and editor trying to deal with documents coming from different sources, and 
c) a good destination for custom ids already exists, attribute guid, that has exactly the stated purpose and allows custom ids without polluting the id space expressed by eIds and wIds. 
[ELI + OP] Using the prescribed syntax must not be requirement for compliance to Akoma Ntoso nor for the use of the eId / wId attributes. If desired, an additional compliance level could be defined for those users of Akoma Ntoso who want to use a resolver. The use of a resolver must not be forced on users of the schema who have no interest in using this functionality. So, usage of a predefined inner identifier structure should be an option (CAN), not an obligation (MUST), except perhaps in said specific compliance level

 

This is exactly the case it is now. You can use GUID attributes at the first level of compliancy. Using eId and wId is only at the second level of compliancy. but IF you use eId and wId, we insist on you adopting the syntax provided for these attributes. This guarantees that the resolution can take place with no ill effects and without misunderstandings, especially in the case of renumbered fragments in a versioned context.  

[KUSTER Marc (OPOCE)] Well, no. The request is exactly that, if you use eId and wId, you must not be constrained to use any specific identifier structure.

 

 

From: monica.palmirani [mailto:monica.palmirani@unibo.it]
Sent: Tuesday, July 26, 2016 11:59 PM
To: KUSTER Marc (OP)
Cc: 'Fabio Vitali'; Catherine Tabone; 'Søren Broberg Nielsen (957sbn)'; Patrice Platel; 'Gerry''; Jean-Michel THIVEL; 'Nina Koch (957nko)'; ''aki.hietanen@om.fi'; SCIARRINO Valeria (OP); KOENIG Kurt (OP); MALAGON Carmen (OP); SCHMITZ Peter (OP); PAPPALARDO Roberto (OP); KARDAMI Maria (OP); BAGOLA Holger (OP); 'John.Dann@scl.etat.lu'; FRANCESCONI Enrico (OP);
legaldocml@lists.oasis-open.org; legaldocml-comment@lists.oasis-open.org
Subject: Re: [legaldocml] Public Comments

 

Dear Marc, dear ELI group,

 

that was a fairly disappointing answer to our compromise proposal. In fact, we felt it was not even a search of compromise, but a hardening of reciprocal position of distrust. It would be very sorry if that was the case. We would have welcomed counterproposals and discussions, rather than a plain and cold yes/no judgment on individual items. 

 

The proposed compromise was meant exactly to accommodate a number of other naming conventions, including country-specific ELI implementations as well as URN:LEX and others. This was meant that ELI implementations could be used transparently within Akoma Ntoso documents with a modicum of effort (ONE ADDITIONAL ELEMENT, that's all). 

 

This shrill reaction seems to mean that you are not interested in considering the compatibility with Akoma Ntoso, but only in excusing yourself from finding good reason to look carefully into it. 

 

In summary: 

 

Thanks for taking up the idea of the functionally equivalent naming convention. However, currently the ELI naming convention seems to be only partially accommodated but subject to AKN conditions as opposed to being on “an equal footing” and this will need to evolve significantly.

 

We never meant to introduce an equal footing for the ELI naming convention specifically. We aimed at allowing reasonably sophisticated naming conventions different from the native Akoma Ntoso to be used everywhere an URI ref is allowed. Nothing specific for ELI, but we fully expected that most ELI Implementations that we are aware of, including UK, EU, FR, and others, could immediately apply. 

 

 

 

Dear John & John, 
 
during the last LegalDocML TC, on June 29th, the group has analyzed your comments and discussed about a possible way to satisfy both your concerns and our need to preserve the consistency of our overall design of the Akoma Ntoso proposal. 
 
In this message we would like to advance to you, informally, the gist of the solution, and once we receive your approval, proceed to actually draft and emit a new version of the documentation for the formal approval procedure. 
 
Briefly, the most relevant and pivotal comment is on the naming convention and on your request to allow "on an equal footing" other naming conventions than Akoma Ntoso's own one. We understand the request and the underlying need, and we are inclined to accept that as long as we can express a few simple and reasonable requirements. 
 
In brief, we would like to adopt your concept of "functionally equivalent naming convention" (FENC), specify that only FENCs are acceptable in Akoma Ntoso XML documents, and provide a few reasonable indications of what we mean by functional equivalence. 
 
A functionally equivalent naming convention is defined as follows: 
 
 [ELI + OP] Disagree with most of these requirements. Why are they needed? Some of these requirements are highly subjective (when is something "memorizable", "global" etc.)? Who would measure these and decide on the possible compliance as functionally equivalent naming convention?

 

It may be difficult to follow this, but compliance cannot be requested nor enforced. Akoma Ntoso does not have guns, and no institution is emitting licenses allowing one to use Akoma Ntoso if an only if some requirement is followed. 

 

You can use the Akoma Ntoso XML vocabulary and your own naming convention in it and nobody will sue you. 

 

The only thing we can do is to provide a series of guidelines on how to use the language. These guidelines are only meant to guarantee interoperability of tools and datasets. Adopting only part of these guidelines means only that you admit that you do not care very much for interoperability of tools and datasets. Which you are absolutely free to do, but it is not fully compliant with LegalDocML OASIS conformance rules that we intend to provide to the world.

 

Any naming convention that declares itself to be functionally equivalent, is persistent and well publicly documented must qualify. 
 
 
1)  *recognizable*: a syntactical means exists to recognize the specific syntax used for the URI (e.g., a specific prefix); 
[ELI + OP] This would largely be the case for ELI (and ECLI), but why this requirement? Also the /eli/ part is _not_ a mandatory part of the ELI identifier syntax (and the UK doesn't have it…). 

 

No part of ELI is mandatory, not even the eli prefix itself. In fact, we do not look at ELI, which in our mind does not even exist for exactly this reason, but to individual ELI implementations, which usually DO adopt such prefix. In an interoperable world (which is where we would like to exist), recognizing that a URI is, in fact, a UK uri as opposed to a French URI is interesting. This is the reason to require such a syntactical means. 

 

2)  *published*: a sufficiently detailed description of the syntax is publicly available and backed by a recognizable institution; 
[ELI + OP] OK (assuming that "recognizeable institution" = relevant stakeholder). Otherwise, badly defined

 

please provide a better definition. We did not plan to define it at all, we only tried to find a common ground. Simply sying "Not enough, try again" does not help the cooperation.

 

 
3)  *FRBR compliant*: A full distinction between "distinct intellectual creations", "specific intellectual forms", "physical embodiments" and "exemplars" of relevant documents must be explicitly supported and aligned with the FRBR conceptualizations. Support for items is not necessary nor requested. 
[ELI + OP] Why is this relevant at the identifier level? As it is formulated, it is unclear if ELI complies to this or not

 

actually ELI conformance rules do not exist. Many individual ELI implementations, including UK, EU, FR, as far as we are aware of, do comply. 

 

As to the reason for this: FRBR is FUNDAMENTAL everywhere in Akoma Ntoso. It is one of the basic building blocks of Akoma Ntoso. We are NOT going to requiring a good support for FRBR just because within the ELI group you were not able to reach a consensus on its meaning. 

 
4) *CEN Metalex compliant*: the seven rules in CEN Metalex requirements (section 6.1 of [1]) must be fully implemented: 
 "To allow for the discovery of IRI identifiers, names must be:
      1. Persistent: names at all levels must maintain the same form over time regardless of the political,
         archival and technical events happened since their first generation;
 [ELI + OP] OK
 
      2. Global: all relevant documents by all relevant bodies must be represented;
 [ELI + OP] What does this mean? Documents are globally accessible or the scheme is globally applicable? If the last, why? 
What are "all relevant bodies"?

As explicitly specified, we are mentioning a third party document (CEN Metalex, ftp://ftp.cen.eu/CEN/Sectors/List/ICT/CWAs/CWA15710-2010-Metalex2.pdf ) which existed before this naming convention. This document lists in a very generic form a set of requirements for CEN Metalex compliancy. The Akoma Ntoso Naming Convention, in the mind of its proponents, does its best to comply with them. Functional equivalence, in our mind, means exactly that the candidate naming convention must have the same consideration for the CEN Metalex requirements that we had. 

 

The actual answers can and must be found in the CEN Metalex document, if anywhere. Both questions you raise, nonetheless, are easy to answer: 

 

1) The scheme must be globally applicable to all documents to which it claims to apply. Easy. 

2) The relevant bodies are all organizations emitting documents for which the candidate naming convention claims to apply. Also easy. 

 

 
      3. Memorizable: names should be easy to write down, easy to remember, easy to correct if they were written
         down wrongly;
[ELI + OP] In principle OK, though subjective


Ok. 

 

 

 
      4. Meaningful: names should mean something; It should be possible to make assumption about the kind, freshness
         and relevance of a citation by looking only at the document’s name;
 [ELI + OP] OK (but what does freshness mean)

 

Our take: in  a versioned document, it should be possible to make assumption about the actual version you are interested in. 

 

      5. Guessable across levels: references to different levels of the same document must be similar; e.g., 
         given a reference to an _expression_ a user should be able to deduce the name of the work;
 [ELI + OP] OK
 
      6. Guessable across document classes: references to different instances of the same document type must 
         be similar; and
 [ELI + OP] OK
 
      7. Guessable across document components: references to different components of the same document at the 
         same level must be similar."
 [ELI + OP] OK
 
4)  *active*: at least one working, accessible, available, robust resolver must exist that provides dereferencing of URIs/IRIs according to the specific syntax;
 [ELI + OP] No resolver must be required, unless this includes is the general http resolution mechanism

 

IF the resolution of your identifier can happen through the general http resolution, THEN you automatically comply. This is NOT the case for ALL candidate naming convention, so we felt the need to add this requirement. 

 

 
5)  *equivalent*: at least one working, accessible, available, robust converter must exist that converts URIs/IRIs according to the specific syntax into equivalent URIs/IRIs according to the Akoma Ntoso Naming convention; 
[ELI + OP] In this case the Akoma Ntoso Naming convention is the privileged partner and not a choice on "an equal footing". 
In practical terms, who would maintain such a converter?

 

Being an Akoma Ntoso document means BOTH using the Akoma Ntoso XML vocabulary AND being part of a network of document collections that talk to each other. This is probably NOT a requirement for ELI, but it is one for Akoma Ntoso. 

 

Interoperability, thus, means that a resolver should be able to resolve URIs regardless of the naming convention used, and in particular source documents using internally a naming convention which is different than the one used by the document base where the destination document is stored should be able to access the destination document anyway. 

 

The opposite, i.e., requiring that the author of the source document KNOWS which naming convention is used in the destination document collection, hardly seems robust and interoperable. 

 

6)  *evident*: Akoma Ntoso XML documents identifying themselves (in <FRBRUri> and <FRBRThis> elements) using a FENC URI, must also provide equivalent <FRBRalias> elements with the URI ref corresponding to <FRBRThis> according to the Akoma Ntoso Naming Convention, one for each of the first three FRBR levels. 
[ELI + OP] Unacceptable. As an effect of this everybody would have to support the Akoma Ntoso naming convention in any case, the only difference being that in this case ELI is the primary schema and Akoma Ntoso the obligatory second one. In this, the Akoma Ntoso naming convention retains a privileged position and is not at all "on an equal footing"

 

Equal footing, in our mind, does not mean ignoring each other. It means actively looking for a compromise situation where the syntax may differ, but the functionalities stay the same. Interoperability is the MOST IMPORTANT functional requirement for being part of the Akoma Ntoso world. You cannot have interoperability if you do not allow resolver to access documents using a different naming convention that the source document uses. This is the only justification for this requirement. 

 

In practice, this requires that ONE element per FRBR level (THREE element total) are added to an Akoma Ntoso XML document to be compliant with this requirement. All links, all components, all references, all annotations

 

As said, you can use Akoma Ntoso XML documents with no legal consequences. Nonetheless, if you want OUR resolvers to access your documents, you must allow them to discover the Akoma Ntoso equivalent URIs. 

 

Any Naming Convention that complies with these requirements is termed a *functionally-equivalent Naming Convention* and its URIs can be used in any situation where Akoma Ntoso URIs/IRIs are appropriate. 
 
Finally we resist at allowing custom syntaxes for inner-document ids in eId and wId, because 
a) inner document identifiers are a reflection of the overall XML structure, which is still Akoma Ntoso, and not of the document-level URI syntax adopted, 
b) allowing multiple syntaxes for the same attributes would create havocs in any decent resolver and editor trying to deal with documents coming from different sources, and 
c) a good destination for custom ids already exists, attribute guid, that has exactly the stated purpose and allows custom ids without polluting the id space expressed by eIds and wIds. 
[ELI + OP] Using the prescribed syntax must not be requirement for compliance to Akoma Ntoso nor for the use of the eId / wId attributes. If desired, an additional compliance level could be defined for those users of Akoma Ntoso who want to use a resolver. The use of a resolver must not be forced on users of the schema who have no interest in using this functionality. So, usage of a predefined inner identifier structure should be an option (CAN), not an obligation (MUST), except perhaps in said specific compliance level

 

This is exactly the case it is now. You can use GUID attributes at the first level of compliancy. Using eId and wId is only at the second level of compliancy. but IF you use eId and wId, we insist on you adopting the syntax provided for these attributes. This guarantees that the resolution can take place with no ill effects and without misunderstandings, especially in the case of renumbered fragments in a versioned context.  

 

Regards,

 

Fabio Vitali & Monica



Il 22/07/2016 12:32, KUSTER Marc (OP) ha scritto:

Dear Monica, Fabio,

 

Thanks for taking up the idea of the functionally equivalent naming convention. However, currently the ELI naming convention seems to be only partially accommodated but subject to AKN conditions as opposed to being on “an equal footing” and this will need to evolve significantly.

 

Please find here the ELI TF's and OP's reactions. I am, of course, at your disposal for further discussions.

 

Best regards

 

Marc

 

 

 

From: monica.palmirani [mailto:monica.palmirani@unibo.it]
Sent: 20 July 2016 11:44
To: John Dann; John Sheridan
Cc: Fabio Vitali; Catherine Tabone; 'Søren Broberg Nielsen (957sbn)'; Patrice Platel; 'Matthews, Gerry'; Jean-Michel THIVEL; 'Nina Koch (957nko)'; 'Hietanen Aki (OM) (
aki.hietanen@om.fi)'; SCIARRINO Valeria (OP); KOENIG Kurt (OP); MALAGON Carmen (OP); SCHMITZ Peter (OP); PAPPALARDO Roberto (OP); KARDAMI Maria (OP); BAGOLA Holger (OP)
Subject: Re: [legaldocml] Public Comments

 

Dear John & John,

we were wondering if you have received any comment about our proposal for the modification to the compliance with the Akoma Ntoso naming convention.
Tomorrow we will have our LegalDocML TC meeting and it would be nice to have some inputs on this issue.

We intend to speed up the standardization process soon, especially since Monica was elected in the OASIS Board of Directors.

All the best,
Monica and Fabio

Il 12/07/2016 13:57, John Dann ha scritto:

Hi Monica,

 

Thanks for taking into consideration our comments.

 

I forward your proposition to the ELI TF, as I sent the comments on behalf of all, and also the OPUE, whose comments we all supported, so they can also react.

 

I am sure we will find a suitable flexible solution.

 

John

 

From: monica.palmirani [mailto:monica.palmirani@unibo.it]
Sent: Tuesday, July 12, 2016 12:04 PM
To: John Dann
<John.Dann@scl.etat.lu>; 'Sheridan, John' <jsheridan@nationalarchives.gsi.gov.uk>
Cc: Fabio Vitali
<fabio@CS.UniBO.IT>
Subject: [legaldocml] Public Comments

 

Dear John & John, 
 
during the last LegalDocML TC, on June 29th, the group has analyzed your comments and discussed about a possible way to satisfy both your concerns and our need to preserve the consistency of our overall design of the Akoma Ntoso proposal. 
 
In this message we would like to advance to you, informally, the gist of the solution, and once we receive your approval, proceed to actually draft and emit a new version of the documentation for the formal approval procedure. 
 
Briefly, the most relevant and pivotal comment is on the naming convention and on your request to allow "on an equal footing" other naming conventions than Akoma Ntoso's own one. We understand the request and the underlying need, and we are inclined to accept that as long as we can express a few simple and reasonable requirements. 
 
In brief, we would like to adopt your concept of "functionally equivalent naming convention" (FENC), specify that only FENCs are acceptable in Akoma Ntoso XML documents, and provide a few reasonable indications of what we mean by functional equivalence. 
 
A functionally equivalent naming convention is defined as follows: 
 
 [ELI + OP] Disagree with most of these requirements. Why are they needed? Some of these requirements are highly subjective (when is something "memorizable", "global" etc.)? Who would measure these and decide on the possible compliance as functionally equivalent naming convention?
Any naming convention that declares itself to be functionally equivalent, is persistent and well publicly documented must qualify. 
 
 
1)  *recognizable*: a syntactical means exists to recognize the specific syntax used for the URI (e.g., a specific prefix); 
[ELI + OP] This would largely be the case for ELI (and ECLI), but why this requirement? Also the /eli/ part is _not_ a mandatory part of the ELI identifier syntax (and the UK doesn't have it…). 
2)  *published*: a sufficiently detailed description of the syntax is publicly available and backed by a recognizable institution; 
[ELI + OP] OK (assuming that "recognizeable institution" = relevant stakeholder). Otherwise, badly defined
 
3)  *FRBR compliant*: A full distinction between "distinct intellectual creations", "specific intellectual forms", "physical embodiments" and "exemplars" of relevant documents must be explicitly supported and aligned with the FRBR conceptualizations. Support for items is not necessary nor requested. 
[ELI + OP] Why is this relevant at the identifier level? As it is formulated, it is unclear if ELI complies to this or not
 
4) *CEN Metalex compliant*: the seven rules in CEN Metalex requirements (section 6.1 of [1]) must be fully implemented: 
 "To allow for the discovery of IRI identifiers, names must be:
      1. Persistent: names at all levels must maintain the same form over time regardless of the political,
         archival and technical events happened since their first generation;
 [ELI + OP] OK
 
      2. Global: all relevant documents by all relevant bodies must be represented;
 [ELI + OP] What does this mean? Documents are globally accessible or the scheme is globally applicable? If the last, why? 
What are "all relevant bodies"?
 
      3. Memorizable: names should be easy to write down, easy to remember, easy to correct if they were written
         down wrongly;
[ELI + OP] In principle OK, though subjective
 
      4. Meaningful: names should mean something; It should be possible to make assumption about the kind, freshness
         and relevance of a citation by looking only at the document’s name;
 [ELI + OP] OK (but what does freshness mean)
      5. Guessable across levels: references to different levels of the same document must be similar; e.g., 
         given a reference to an _expression_ a user should be able to deduce the name of the work;
 [ELI + OP] OK
 
      6. Guessable across document classes: references to different instances of the same document type must 
         be similar; and
 [ELI + OP] OK
 
      7. Guessable across document components: references to different components of the same document at the 
         same level must be similar."
 [ELI + OP] OK
 
4)  *active*: at least one working, accessible, available, robust resolver must exist that provides dereferencing of URIs/IRIs according to the specific syntax;
 [ELI + OP] No resolver must be required, unless this includes is the general http resolution mechanism
 
5)  *equivalent*: at least one working, accessible, available, robust converter must exist that converts URIs/IRIs according to the specific syntax into equivalent URIs/IRIs according to the Akoma Ntoso Naming convention; 
[ELI + OP] In this case the Akoma Ntoso Naming convention is the privileged partner and not a choice on "an equal footing". 
In practical terms, who would maintain such a converter?
 
6)  *evident*: Akoma Ntoso XML documents identifying themselves (in <FRBRUri> and <FRBRThis> elements) using a FENC URI, must also provide equivalent <FRBRalias> elements with the URI ref corresponding to <FRBRThis> according to the Akoma Ntoso Naming Convention, one for each of the first three FRBR levels. 
[ELI + OP] Unacceptable. As an effect of this everybody would have to support the Akoma Ntoso naming convention in any case, the only difference being that in this case ELI is the primary schema and Akoma Ntoso the obligatory second one. In this, the Akoma Ntoso naming convention retains a privileged position and is not at all "on an equal footing"
 
 
Any Naming Convention that complies with these requirements is termed a *functionally-equivalent Naming Convention* and its URIs can be used in any situation where Akoma Ntoso URIs/IRIs are appropriate. 
 
Finally we resist at allowing custom syntaxes for inner-document ids in eId and wId, because 
a) inner document identifiers are a reflection of the overall XML structure, which is still Akoma Ntoso, and not of the document-level URI syntax adopted, 
b) allowing multiple syntaxes for the same attributes would create havocs in any decent resolver and editor trying to deal with documents coming from different sources, and 
c) a good destination for custom ids already exists, attribute guid, that has exactly the stated purpose and allows custom ids without polluting the id space expressed by eIds and wIds. 
[ELI + OP] Using the prescribed syntax must not be requirement for compliance to Akoma Ntoso nor for the use of the eId / wId attributes. If desired, an additional compliance level could be defined for those users of Akoma Ntoso who want to use a resolver. The use of a resolver must not be forced on users of the schema who have no interest in using this functionality. So, usage of a predefined inner identifier structure should be an option (CAN), not an obligation (MUST), except perhaps in said specific compliance level
 
[1] ftp://ftp.cen.eu/CEN/Sectors/List/ICT/CWAs/CWA15710-2010-Metalex2.pdf
 
We plan to work on a new draft including this kind of flexibility, and would appreciate your opinion within the next week.
 
Thank you for your comments and opinions on this. 
 
Monica and Fabio



Il 21/06/2016 08:48, John Dann ha scritto:

Dear members of the LegalDocumentML

As Chair of the ELI Task Force, and on behalf of

·         Denmark

·         Finland

·         Ireland

·         Luxembourg

·         Publications Office of the European Union (comments also sent individually)

·         United-Kingdom (comments also sent individually)

·         France

we would like to send the following comments.

Constructing a universal naming convention, given the differences in national legal systems, is very complex and does not cover all national legislation cases and especially hinder existing naming conventions.

In line with the principle of proportionality and the principle of decentralization, each country and company should continue to operate its own national Official Journals, Legal Gazettes or legal databases in the way they prefer. We should therefore carefully consider not to impose a naming convention in order to respect the legal and constitutional differences between countries, and authorize on equal footing other naming conventions, e.g. URN-Lex, ECLI, ELI etc.

This flexibility would help the implementation of the revised version of AKN.

We therefore fully support the comments of the Office of Publications of the EU sent earlier by email.

 

Best regards,

 

John

 

John Dann

Directeur

LE GOUVERNEMENT DU GRAND-DUCHÉ DE
LUXEMBOURG
Ministère d'État

Service central de législation

43, bd Roosevelt . L-2450 Luxembourg

Tél. (+352) 247-82961 . Fax (+352) 46 74 58
E-mail :
john.dann@scl.etat.lu

www.legilux.public.lu 

 

 

 

 

 

-- 
===================================
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 
====================================
 

 

 

-- 
===================================
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 
====================================
 

 

 

-- 
===================================
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 
====================================
 


-- 
===================================
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 
====================================



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]