Comments (6)
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.
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.
@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.
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.
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.
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)
- some links to tools.ietf.org are broken HOT 1
- XEP References missing HOT 9
- State license of bibliographic data
- Have CI automatically check XEP-0001 conformance HOT 4
- Automate publication of new documents HOT 3
- Automate attic maintenance HOT 4
- Facilitate triaging through automation HOT 5
- Automate email notifications HOT 2
- XEP-0004: dead link to Protocol Namespaces
- Create tool to validate standalone XEP-0001 conformance
- Devise a robust, transactional system for "publishing" repository versions HOT 2
- Create tool to execute the triaging workflow HOT 4
- Create tool to facilitate automatic creation of git tags for new XEP releases
- Create tool to validate that no changes are made to a XEP after the most recent revision block in a commit range
- Integrate new tooling into pull request CI
- Integrate new tooling into main branch CI
- XEP-0390: Initiate Last Call HOT 2
- Document in attic should include disclaimer HOT 2
- XEP-0266 non-semver version string
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
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.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from xeps.