Join GitHub today
GitHub is home to over 20 million developers working together to host and review code, manage projects, and build software together.
Infrastructure for links to specification #109
As per #108 it would be nice to be able to add links to specifications and references like the MDN.
It'd be better if we added this to the markdown files and then add some CSS hooks in the template to make this styled consistently.
Currently this just adds the links belong the textual context without any styling.
As an aside do we want to favour links to W3C HTML5 or WHATWG HTML? (I favour WHATWG).
We have a meta tag called moreurl that you can set on each markdown post to indicate more info. See http://html5please.us/#exclusions where we link to 'learn more'.
Initially I had linked the name itself for that, but @paulirish said it was not good-looking, and we moved it there. Also we link to caniuse.com too but call it
@nimbupani I saw that you already have moreurl.
The issue here is that it allows only one link. What if we want to link to both the MDN reference and the W3C/WHATWG specification. I think both of those are valid references.
It also appears that moreurl doubles as both a learn more and a caniuse url. Basically if it's not present it renders the caniuse url and if moreurl is present it overwrite the caniuse url.
I don't think this is generic enough to link to references, having three links (W3C, MDN, caniuse) would be useful.
I think caniuse links are important for all items, as long as we can have them..
still... learning more about a specific feature is useful. And I'd rather just see the most useful resource for each feature than standardizing on a destination. (like css-tricks probably is this for a number)
yeah i'm +1 on this. i like the implementation too
referenced this pull request
Jan 26, 2012
talking to divya about this i think we dont need to make this a new data field.. let's just add it inline in the prose when the feature could use it.. i agree
.. this way its less formal and we dont have superfluous link maintenance.. just adding extra links for features when it makes sense.
linking to specs might not always make sense and MDN articles might not be present so its best to leave this flexible and conversational.
added a commit
this pull request
Jan 26, 2012
@paulirish still opens the question as to whether we want to go and add specification links for every feature we can?
I just thought that having a single location for every item which links to the specification like we have the single caniuse link location would be useful.