Also, I am not saying that I think OASIS is unprofessional/unorganized… quite the opposite. But it may be a thought someone who isn’t heavily involved with OASIS
may think. It may not even be in reference to OASIS but the editors, or the chair, or the TC… I was trying to make a generalized statement targeted at no one. I am going to :-X I already feel like I’m in a hole.
---
Kevin Mangold
National Institute of Standards and Technology
Information Technology Lab / Information Access Division / Image Group / Biometric Clients Lab
Office: 301-975-5628
From:
tab@lists.oasis-open.org [mailto:
tab@lists.oasis-open.org]
On Behalf Of Mangold, Kevin C.
Sent: Thursday, October 8, 2015 16:27
To: Patrick Durusau <
patrick@durusau.net>;
tab@lists.oasis-open.org Subject: RE: [tab] Re: IETF and W3C citation lists posted to the TAB
“If you mean we should regularize the citations of both organizations into yet a third style, I am much less sympathetic.” – this is pretty much what I was thinking.
“Part of my concern over TC citation practice is the inability to easily find the works they are citing, if they make up citations on their own.” – I understand
the concern but I can’t imagine it being that big of a deal (but I have no data to support that statement -- if you do, then I’ll gratefully and graciously concede). What I am envisioning is the inability to quickly go through and discern each citation without
having to mentally relearn a new format. (Not to mention the cringes that probably every English teacher/professor/tech editor will give (including me… which is why I bring it up
J )). There is also the possibility that some may consider it unprofessional for an organization to
allow such variances?
If this is “all that is possible at the moment”, then so be it. I, at least wanted to bring it up, perhaps a topic of discussion for future citation lists releases.
Also, if the TAB is putting out citation lists where each list is a different format, then we will have to be careful to avoid comments on a non-harmonious list
of citations.
Anyways, my thoughts on this.
J
Kevin
---
Kevin Mangold
National Institute of Standards and Technology
Information Technology Lab / Information Access Division / Image Group / Biometric Clients Lab
Office: 301-975-5628
From:
tab@lists.oasis-open.org [mailto:
tab@lists.oasis-open.org]
On Behalf Of Patrick Durusau
Sent: Thursday, October 8, 2015 15:54
To:
tab@lists.oasis-open.org Subject: Re: [tab] Re: IETF and W3C citation lists posted to the TAB
Kevin,
Well, if you are suggesting that both of the lists should be:
[LABEL] (here follows the organization's citation, I think that is a great idea. I put the label for W3C at the end so I could say "suggested" to appease people don't like following the styles of issuing organizations.
If you mean we should regularize the citations of both organizations into yet a third style, I am much less sympathetic.
Part of my concern over TC citation practice is the inability to easily find the works they are citing, if they make up citations on their own.
The same is true for re-writing W3C citations to say: [LABEL] [AUTHORS] [TITLE] etc. because I won't be able to locate other documents citing that standard. Why? Because I am using an unknown or perhaps little used version of the correct citation.
Granting it is a mixture of styles but one of the impediments thus far in producing any guidance on bibliographies has been the mountain sized task of creating a bibliographic model for all citations. Or perhaps better, all the citations likely to be made by
OASIS TCs.
Rather than tackling that nut, I was proposing that we at least have TCs cite the materials as they are cited by their issuing organizations.
It's not my top choice but it does avoid the morass that is bibilographic citation by TCs now. Out of all the citations of RFC 2119 prior to when we started this work, none, none of them were correct. Including in the templates.
In a perfect world I would be supporting you and Robin in particular on the quest for a common bibliographic model. But to avoid amateurish looking citations, this level of guidance may be all that is possible at the moment.
Hope the INCITS meeting went well!
Patrick
On 10/08/2015 03:12 PM, Mangold, Kevin C. wrote:
Hmm. I thought these citation lists were to help editors by making it easy and having correct/up to date citations in their document by simply allowing them to
copy/paste.
IETF:
[RFC5141] Goodwin, J. and H. Apel, "A Uniform Resource Name (URN) Namespace for the International Organization for Standardization (ISO)", RFC 5141, DOI 10.17487/RFC5141,
March 2008, <http://www.rfc-editor.org/info/rfc5141> .
[LABEL] Author/Editor(s), “Long Title”, Short Title, DOI, Publication Date, <Link>
W3C:
Namespaces in XML 1.0 (Third Edition), T. Bray, D. Hollander, A. Layman, R. Tobin, H. Thompson, Editors, W3C Recommendation, December 8, 2009,
http://www.w3.org/TR/2009/REC-xml-names-20091208 .
Latest version available at
http://www.w3.org/TR/xml-names .
[Suggested label: XML-NAMES]
[LABEL] Title, Author/Editor(s), Document type, Publication Date, link.
If I have a mixed bag of IETF and W3C references in my document, it’ll look something like:
[LABEL] Author/Editor(s), “Long Title”, Short Title, DOI, Publication Date, <Link>
[LABEL] Author/Editor(s), “Long Title”, Short Title, DOI, Publication Date, <Link>
[LABEL] Title, Author/Editor(s), Document type, Publication Date, link.
[LABEL] Title, Author/Editor(s), Document type, Publication Date, link.
[LABEL] Author/Editor(s), “Long Title”, Short Title, DOI, Publication Date, <Link>
[LABEL] Title, Author/Editor(s), Document type, Publication Date, link.
[LABEL] Author/Editor(s), “Long Title”, Short Title, DOI, Publication Date, <Link>
The ordering is mixed up which leads to a non-homogenous citation list; imagine seeing a paper where some citations are MLA and some are APA. If my assumption
at the very top of this email is accurate, then I think the label (whether suggested or not) should appear identically, along with ordering of document metadata, regardless of the organization. And less of a homogeneity, but the fonts are different, too.
Again, I apologize for bringing this up now – I have been in all day INCITS meetings this week and I am finally catching up to emails. I saw the W3C citation
list that you sent out on 9/24, but knew that was a “making progress” document and was assuming the formats would be the same.
Kevin
---
Kevin Mangold
National Institute of Standards and Technology
Information Technology Lab / Information Access Division / Image Group / Biometric Clients Lab
Office: 301-975-5628
From:
tab@lists.oasis-open.org [ mailto:
tab@lists.oasis-open.org ]
On Behalf Of Patrick Durusau
Sent: Thursday, October 8, 2015 14:53
To:
tab@lists.oasis-open.org Subject: Re: [tab] Re: IETF and W3C citation lists posted to the TAB
Kevin,
The formats of the issuing organizations are different.
We could add [suggested labels] for the RFCs if anyone asks or if that helps with your concern.
I suspect (don't remember thinking about it) I did labels for the W3C and not RFCs b/c the W3C Bibliography Generator offers default labels. Just following their output.
Hope you are having a great day!
Patrick
On 10/08/2015 02:41 PM, Mangold, Kevin C. wrote:
Hmm… the format of the citation for W3C is different than IETF… sorry this is the first time I am looking at the W3C one… is this intentional?
---
Kevin Mangold
National Institute of Standards and Technology
Information Technology Lab / Information Access Division / Image Group / Biometric Clients Lab
Office: 301-975-5628
From:
tab@lists.oasis-open.org [ mailto:
tab@lists.oasis-open.org ]
On Behalf Of Chet Ensign
Sent: Thursday, October 8, 2015 14:31
To: Patrick Durusau <
patrick@durusau.net>
Cc:
tab@lists.oasis-open.org Subject: [tab] Re: IETF and W3C citation lists posted to the TAB
Folks, this looks good to me too. I think we are all on board so I will send this along to the Board now.
/chet
On Mon, Oct 5, 2015 at 3:29 PM, Patrick Durusau <
patrick@durusau.net > wrote:
Chet,
I have posted the final versions (I hope) of the Fall IETF and W3C citation lists to the TAB.
Please give TAB members a brief window to comment before posting these to the Board.
Once they go public, I will post these to the TAB file archive along with the source code and comments for generating them.
Hope you are at the start of a great week!
Patrick
PS: BTW, searching for meaningful information on XQuery is nearly a disaster. The keywords are quite common (one problem) and the other is that no search engine allows you to search for keywords embedded in other statements.
A curated resource on XQuery might be of a great deal of interest in the XML community. You may think of Walmsley's book as such a resource but its not. Same searching difficulties as the web.
--
Patrick Durusau
patrick@durusau.net Technical Advisory Board, OASIS (TAB)
OpenDocument Format TC (OASIS), Project Editor ISO/IEC 26300
Co-Editor 13250-5 (Topic Maps)
Another Word For It (blog):
http://tm.durusau.net Homepage:
http://www.durusau.net Twitter: patrickDurusau
--
/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
--
Patrick Durusau
patrick@durusau.net Technical Advisory Board, OASIS (TAB)
OpenDocument Format TC (OASIS), Project Editor ISO/IEC 26300
Co-Editor 13250-5 (Topic Maps)
Another Word For It (blog):
http://tm.durusau.net Homepage:
http://www.durusau.net Twitter: patrickDurusau
--
Patrick Durusau
patrick@durusau.net Technical Advisory Board, OASIS (TAB)
OpenDocument Format TC (OASIS), Project Editor ISO/IEC 26300
Co-Editor 13250-5 (Topic Maps)
Another Word For It (blog):
http://tm.durusau.net Homepage:
http://www.durusau.net Twitter: patrickDurusau