Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Granted, it depends on how it turns out. But my first impression is that authoritative reference documents of MDN are going to become cluttered with comments and disagreements.


MDN has never been "authoritative reference documents". It's a wiki. Anybody can edit and republish pages, change examples, do whatever. I noticed somewhere about a year ago that it was a wiki, and have made minor changes to a couple of pages since then, when something was missing an example or something.

I change, I publish, it's done. And if my change was wrong, or opinionated, or bad, it's just like that until somebody else catches it and fixes it back.


Neither Safari, Chrome/Chromium, IE, old Edge, nor new Edge have substantial HTML and CSS developer documentation on their own web sites. Their vendors - excepting Apple and the WebKit contributors - all chose to work with Mozilla instead to put their docs on MDN: https://blogs.windows.com/msedgedev/2017/10/18/documenting-w...

It seems to me that as far as the browser makers are concerned, MDN is as close to authoritative as you can get without going to the standards documents themselves - and the standards don't give you browser compatibility matrices or make any note of browser-specific quirks.

MDN may be a wiki, but it certainly isn't treated like one by the people who are most interested in it being accurate and up to date.


I suppose I was reacting to this:

"Authoritative reference documents of MDN are going to become cluttered with comments and disagreements"

Which suggests previously authoritative docs are becoming less so due to being editable. I'm just pointing out they are and always have been subject to edits from the public. If anything the PR process will likely increase the reliability of the info because there would be a chance to do some vetting of changes.

I totally agree that MDN is as close to authoritative as you can get, but it's one (important) step away.


I think people put authoritative sources on too much of a pedestal because it's possible for someone to naively or maliciously edit wikis. People who write official docs are also frequently wrong, and the editing and review cycle there is far slower!

Every recent review I've seen of Wikipedia vs arbitrary big-a Authoritative sources has said that both have issues and overall Wikipedia is better.


I hope they don't suffer the same type of problem that caniuse has had since incorporating the MDN data. In that case, source data sets that were each well-regarded and, particularly in caniuse's case, well-curated on their own became overwhelming and harder to use than before once combined. The slightly different styles for each source and the partial duplication often seem to obscure the information I'm really trying to get to in the search results now. If MDN is now going to be community-led, I hope they manage to find some arrangement where there is still decent curation and not a Wikipedia/SO-style free for all followed by heavy-handed mod over-reaction.


Why is it now more likely to become cluttered than before?




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: