Technical Advisory Board (TAB)

 View Only
Expand all | Collapse all

IETF and W3C citation lists posted to the TAB

  • 1.  IETF and W3C citation lists posted to the TAB

    Posted 10-05-2015 19:29
    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


  • 2.  Re: [tab] IETF and W3C citation lists posted to the TAB

    Posted 10-05-2015 22:53
    Looks good to me!  Ship it! 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 --------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php -- All the best, Ashok


  • 3.  Re: IETF and W3C citation lists posted to the TAB

    Posted 10-08-2015 18:31
    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 


  • 4.  RE: [tab] Re: IETF and W3C citation lists posted to the TAB

    Posted 10-08-2015 18:42




    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 











  • 5.  Re: [tab] Re: IETF and W3C citation lists posted to the TAB

    Posted 10-08-2015 18:53
    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


  • 6.  RE: [tab] Re: IETF and W3C citation lists posted to the TAB

    Posted 10-08-2015 19:13




    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
     






  • 7.  Re: [tab] Re: IETF and W3C citation lists posted to the TAB

    Posted 10-08-2015 19:54
    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


  • 8.  RE: [tab] Re: IETF and W3C citation lists posted to the TAB

    Posted 10-08-2015 20:27




    “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
     






  • 9.  RE: [tab] Re: IETF and W3C citation lists posted to the TAB

    Posted 10-08-2015 20:32




    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
     






  • 10.  Re: [tab] IETF and W3C citation lists posted to the TAB

    Posted 10-08-2015 21:38
    Kevin: Some time ago, probably before you joined the TAB, I argued that OASIS specs Should have all citations in a standard format, like journals dictate. Patrick talked me out of it saying that IETF, W3C election wanted their specs cited in their own formats.  We can discuss  Ashok On Thursday, October 8, 2015, Mangold, Kevin C. < kevin.mangold@nist.gov > wrote: “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   -- All the best, Ashok


  • 11.  Re: [tab] IETF and W3C citation lists posted to the TAB

    Posted 10-08-2015 23:46
    Interesting. Yes, let's talk about this a bit more, I didn't know there was a history to this and would love to learn what was discussed in the past. On: 08 October 2015 17:38, "Ashok Malhotra" <malhotrasahib@gmail.com> wrote: Kevin: Some time ago, probably before you joined the TAB, I argued that OASIS specs Should have all citations in a standard format, like journals dictate. Patrick talked me out of it saying that IETF, W3C election wanted their specs cited in their own formats.  We can discuss  Ashok On Thursday, October 8, 2015, Mangold, Kevin C. < kevin.mangold@nist.gov > wrote: “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   -- All the best, Ashok