Giter VIP home page Giter VIP logo

Comments (6)

Flowdalic avatar Flowdalic commented on July 18, 2024 1

FWIW, our references under https://xmpp.org/extensions/refs/ are now up to date and regularly generated. I've also created ietf-tools/bibxml-service#302

from xeps.

Flowdalic avatar Flowdalic commented on July 18, 2024

FWIW, since 5d186e6 every XEP has a Biblatex entry (example). I wonder if a similar XSLT can be used to create a bibxml file per XEP.

from xeps.

stpeter avatar stpeter commented on July 18, 2024

@Flowdalic that seems doable. We also maintain(ed) a zipfile and tarfile of all the individual bibxml files, however I'm not sure if the IETF needs those. @rjsparks can clarify for us but I know he is very busy this week with the IETF meeting.

from xeps.

rjsparks avatar rjsparks commented on July 18, 2024

To my knowledge we have not used a zip or tarball of the files.
We do have some older internet-drafts in our archive that used an include mechanism (from xml2rfc v2 days) that have include references like this (from the draft that became RFC7395):

      <?rfc include="http://xmpp.org/extensions/refs/reference.XSF.XEP-0124.xml"?>
      <?rfc include="http://xmpp.org/extensions/refs/reference.XSF.XEP-0156.xml"?>
      <?rfc include="http://xmpp.org/extensions/refs/reference.XSF.XEP-0198.xml"?>
      <?rfc include="http://xmpp.org/extensions/refs/reference.XSF.XEP-0199.xml"?>
      <?rfc include="http://xmpp.org/extensions/refs/reference.XSF.XEP-0206.xml"?>

If those URLs stop working, and anyone tries to pick up a draft like that and edit from it, they will have a bad time.

from xeps.

Flowdalic avatar Flowdalic commented on July 18, 2024

As pointed out by nav in the jdev MUC make refs of this repository creates those refs/reference.XSF.XEP-XXXX.xml files and those appear to be reachable under e.g., http://xmpp.org/extensions/refs/reference.XSF.XEP-0124.xml.

I am bit concerned that the links are not versioned, given that XEPs are living documents, a reference to XEP-0123 could become a reference to a more-or-less different XEP in the future. Maybe it would be better if XEPs where referenced by version, e.g., http://xmpp.org/extensions/refs/reference.XSF.XEP-0124-v1.0.xml. But of course, this has other drawbacks.

from xeps.

stpeter avatar stpeter commented on July 18, 2024

IETF specifications often contain references to living standards (e.g., HTML); this is fine and usually preferred. If it is necessary for a spec to cite a specific version of another standard, that can be worked out manually. Thus I suggest that one citation file per specification is best.

from xeps.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.