GithubHelp home page GithubHelp logo

Comments (9)

dret avatar dret commented on June 17, 2024

i am torn about this one. i am not a big fan of the current "living spec/document" fashion, but i do see that this is happening, and that the more formal distinction TR vs. editor's draft is a similar thing. would you like to see links to both? so far, i simply trust the W3C to make the latest and greatest official version available at the generic URI, and i don't specifically link to a version. any concrete proposal how to change this without creating too much noise, or making it necessary to update the links too often?

from html5-overview.

sideshowbarker avatar sideshowbarker commented on June 17, 2024

TR vs. editor's draft is a similar thing. would you like to see links to both?
any concrete proposal how to change this without creating too much noise

You can take a look http://www.w3.org/TR/#tr_Javascript_APIs to see how we handle it in the similar information we provide at www.w3.org site. For each spec we provide just two links: one to a TR URL and one to a ED URL.

However, I think the way we do it there is still less completely ideal, because for the TR link, it provides dated URLs instead of just the http://www.w3.org/TR// URLs.

or making it necessary to update the links too often?

I think if you were to just use the http://www.w3.org/TR// URLs and the ED URLs, you would basically never need to ever update the links, since those are stable unchanging URLs (to documents that may change).

from html5-overview.

dret avatar dret commented on June 17, 2024

I think if you were to just use the http://www.w3.org/TR// URLs and the ED URLs, you would basically never need to ever update the links, since those are stable unchanging URLs (to documents that may change).

that sounds reasonable, as long as the EDs have generic URIs (which i think they almost always have). i'll try to add that to the code that's processing the XML asap, please stay tuned. it may take some community effort after that to actually add those ED URIs were they exist (hint, hint ;-).

from html5-overview.

sideshowbarker avatar sideshowbarker commented on June 17, 2024

it may take some community effort after that to actually add those ED URIs were they exist (hint, hint ;-).

Sure, no rush and I'm happy to help when needed.

from html5-overview.

dret avatar dret commented on June 17, 2024

please have a look at 31b6ef8 (XML only) and let me know if something as simple as this could be good enough to address this issue.

from html5-overview.

sideshowbarker avatar sideshowbarker commented on June 17, 2024

please have a look at 31b6ef8 (XML only) and let me know if something as simple as this could be good enough to address this issue.

Yeah as I said I the comment there, I think that'd be perfect.

from html5-overview.

dret avatar dret commented on June 17, 2024

7aacb96 is a first attempt (currently only the geofencing WD has such an ED link), please let me know what you think.

from html5-overview.

dret avatar dret commented on June 17, 2024

assuming that the simple link is sufficient, and closing this issue.

from html5-overview.

sideshowbarker avatar sideshowbarker commented on June 17, 2024

7aacb96 is a first attempt (currently only the geofencing WD has such an ED link), please let me know what you think.

Yeah, looks great—thanks

from html5-overview.

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.