News for hackers. Stuff that matters.
Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by parhamn on Thursday October 29, 2020 @12:36PM (#24932351)
Man these kind of views bother me so much. They’re taking one of the most (if not, most) useful documentation sources for cross platform web development that benefits them very little, and moving it to a system of open contribution so it can live past the company’s financial problems. And this is your first take?
Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by wwarner on Thursday October 29, 2020 @12:44PM (#24932421)
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.
Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by newmnhn on Thursday October 29, 2020 @12:53PM (#24932525)
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.

Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by hyperrail on Thursday October 29, 2020 @01:02PM (#24932609)
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.

Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by newmnhn on Thursday October 29, 2020 @02:03PM (#24933264)
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.

Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by Godel_unicode on Thursday October 29, 2020 @01:54PM (#24933158)
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.

Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by Silhouette on Thursday October 29, 2020 @02:20PM (#24933554)
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.
Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by detaro on Thursday October 29, 2020 @01:35PM (#24932959)
Why is it now more likely to become cluttered than before?
Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by nialv7 on Thursday October 29, 2020 @12:58PM (#24932577)
I think you are both right. This is good for the future of MDN, but OTOH cutting cost is likely to be what motivated Mozilla to make this change.
Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by afiori on Friday October 30, 2020 @05:52AM (#24940665)
They had already cut cost, I would phrase it as this change being now even more necessary.
Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by ironmagma on Thursday October 29, 2020 @01:36PM (#24932973)
With corporations, the cynical view is most likely to be the correct view. And I wouldn’t say MDN does very little for Mozilla; it’s the main part of their brand in developers’ mind share. If they want to have a browser without developers who like it, that’s their choice, but it won’t really work out well business wise.
Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by DC-3 on Thursday October 29, 2020 @12:41PM (#24932391)
As far as I can see, Mozilla have no reason to be losing money other than their own mismanagement.
Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by roblabla on Thursday October 29, 2020 @12:57PM (#24932566)
This is an article about MDN, not Mozilla. How exactly does MDN bring money? Do you suggest MDN should be a revenue source? Or do you expect Mozilla to maintain the MDN for free eternally just because?

This is seriously entitled. Mozilla gave us an amazing resource, entirely for free. This attitude isn't right, it's toxic and harmful.

Mozilla is in a spot of difficulty, and instead of taking a resource that is operating entirely at a loss down, they're taking the engineering steps to ensure thez resource can outlive them.

That their mismanagement caused them the difficulty is entirely irrelevant here. It could have happened in a myriad of other ways. We should be praising Mozilla and the MDN tech team for the steps they're taking in making sure the MDN can live on.

Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by eznzt on Thursday October 29, 2020 @01:05PM (#24932642)
It's stuff like MDN that attracts donations.
Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by johnfn on Thursday October 29, 2020 @01:27PM (#24932872)
Fun fact: I have an open source repo with millions of downloads, tens of thousands of active users, and, for at least a year, a prominently displayed donate button. How much in donations do you think it took in over its lifetime?

Hint: it's less than $200.

Donations don't really work.

Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by weaksauce on Thursday October 29, 2020 @02:47PM (#24934016)
Thanks for the vim plugin for vscode! It's quite useful and usable. fwiw i don't think you get many donations because it looks like an official microsoft backed vscode plugin so why would people throw money at microsoft. that said, i do think you are correct in that people in general do not donate to open source individually that much.
Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by sroussey on Thursday October 29, 2020 @02:52PM (#24934096)
We didn’t have many for Firebug either, though we appreciated those we got and funneled them to new contributors living outside the States where it made a difference.
Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by rhizome on Thursday October 29, 2020 @09:16PM (#24938113)
>for at least a year, a prominently displayed donate button.

Just to be sure, are you referring to the "BuyMeCoffee" button on the GitHub page for the extension (https://github.com/VSCodeVim/Vim)?

Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by johnfn on Friday October 30, 2020 @02:30PM (#24945398)
Nah, we used to have a more prominent link. It's been removed since I stopped developing on the extension.
Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by tracker1 on Friday October 30, 2020 @12:32AM (#24939187)
At the bottom of a long scroll isn't something I'd consider prominent. I'd probably change it to simply "Donate" as a button, and put it with the badges at the top. Red, purple or orange as a contrasting color from the blue and green badges.
Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by cambalache on Thursday October 29, 2020 @01:50PM (#24933120)
Which one is it? Maybe you will win a handful of donations here.
Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by polymatter on Thursday October 29, 2020 @02:21PM (#24933562)
Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by mschuster91 on Thursday October 29, 2020 @01:23PM (#24932841)
> Or do you expect Mozilla to maintain the MDN for free eternally just because?

That's what I expect of a non-profit organization dedicated to maintaining one of the last two remaining major browser engines, yes.

Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by afiori on Friday October 30, 2020 @05:55AM (#24940683)
I didn't know that becoming non-profit meant that money is free :)
Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by ori_b on Thursday October 29, 2020 @01:30PM (#24932898)
What are their revenue streams?

Now that antitrust is happening anyways, Google's main reason for shoveling money at them is going away.

Re:MDN Web Docs evolves: Lowdown on the upcoming new platform by contravariant on Thursday October 29, 2020 @01:35PM (#24932953)
Well, the way I see it it was the financial problems who personally made the decision, so that complicated things somewhat.