W3C home > Mailing lists > Public > public-xmlsec@w3.org > August 2011

Re: media type registration (Re: Draft minutes from 16 August 2011)

From: <Frederick.Hirsch@nokia.com>
Date: Tue, 16 Aug 2011 15:36:23 +0000
To: <tlr@w3.org>
CC: <public-xmlsec@w3.org>, <Frederick.Hirsch@nokia.com>
Message-ID: <EDF3570D-204C-4BE9-B1FD-2630483F5701@nokia.com>
Thomas, all

I think it is a very confusing policy to embed a registration document within another document as the references for the two become intermixed and formatting becomes that of the enclosing document etc

That said, the XML Encryption 1.1 media type section contains many references that are now listed in the references of the enclosing document. I think we should keep it that way to simplify maintenance of references (also that is where you'd expect to find document references as a reader).

There are also a number of references to XML Encryption 1.1, the enclosing document.

Putting each inline and attempting to maintain it would be a mistake.

Thus I think we should go with another approach mentioned on the call today, and change each reference in this section to XML Encryption 1.1 to be the text
"XMLENC-CORE1 (this document)" instead of [XMLENC-CORE1]. This should be clear within the context of the enclosing document and similar to the reference that would be used in a separate media type submission request. No corresponding reference will be included in the list of references.

I note we already have an internal link for Security Considerations, so we've already started down this path.

Any disagreement to this approach, or other suggestion?  Please indicate agreement so we can make this change.

Thanks

regards, Frederick

Frederick Hirsch
Nokia



On Aug 16, 2011, at 11:07 AM, Hirsch Frederick (Nokia-CIC/Boston) wrote:

> All
> 
> So we will update that section of the document to contain the reference text itself inline and not produce a reference in the references section of the document, as proposed in http://lists.w3.org/Archives/Public/public-xmlsec/2011Aug/0026.html
> 
> Thanks for the quick response.
> 
> regards, Frederick
> 
> Frederick Hirsch
> Nokia
> 
> 
> 
> On Aug 16, 2011, at 10:56 AM, ext Thomas Roessler wrote:
> 
>> Apologies for not participating in the call.
>> 
>> I see this in the minutes:
>> 
>>> fjh: proposal to remove section 8, XML Encryption Media Type registration from
>>> this document, or restructure as note with reference
>>> 
>>> ... we could put copy of registration into CVS as separate document and then
>>> reference as informational document
>>> 
>>> alternatively put reference in line
>>> 
>>> <scribe> **ACTION:** fjh to check with tlr re removing (and archiving) section
>>> 8 from xml encryption 1.1 [recorded in [http://www.w3.org/2011/08/16-xmlsec-
>>> minutes.html#action03][25]]
>> 
>> (ACTION-826.)
>> 
>> In a nutshell, the answer to this one is in this document:
>> 	http://www.w3.org/2002/06/registering-mediatype.html
>> 
>> Media type registrations must be part of specifications.  What this reminds me of, though, is to ask for review of this updated registration on ietf-types.
>> 
>> Thanks,
>> --
>> Thomas Roessler, W3C  <tlr@w3.org>  (@roessler)
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> On 2011-08-16, at 16:51 +0200, <Frederick.Hirsch@nokia.com> wrote:
>> 
>>> Attached are Draft minutes from today's teleconference, 16 August 2011. I scribed today. HTML follows text.
>>> 
>>> regards, Frederick
>>> 
>>> Frederick Hirsch
>>> Nokia
>>> 
>>> 
>>> <minutes-2011-08-16.txt><minutes-2011-08-16.html>
>> 
> 
Received on Tuesday, 16 August 2011 15:36:59 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:55:16 UTC