An Update on MDN Web Docs
hacks.mozilla.org
hacks.mozilla.org
Is it valuable enough that you'd consider paying for access?
I'd argue that people would pay for MDN. I know I would pay a small fee for so high-quality straight forward information on web APIs.
"Our mission is to ensure the Internet is a global public resource, open and accessible to all. An Internet that truly puts people first, where individuals can shape their own experience and are empowered, safe and independent."
Isn't it the whooooole point of Mozilla that it creates public good for the internet?
Yes
The value of MDN is very much in its being a public good.
I would definitely use huge part of my training budgets for this if that would be an option.
Are you happy with the resulting browser landscape?
What I said about Firefox Developer Edition: if they kept it free but added a paid version, I would pay for it just to directly support Firefox development.
It has to be 100% clear that all funds need to go towards MDN and Firefox Developer tools / Firefox itself in order for me to remain subscribed to either one.
Firefox has been my browser for decades now, and MDN has been my bread and butter since whenever I discovered how useful it was.
They list a buncha awards and convention type events, that's not helping Firefox at all.
And yes: IMO this is kibd of backwards. Firefox has been their biggest contribution to the open web and it seems they are treating it as just an income source.
So I'm not sure what practical purpose you are aiming at.
Maybe Mozilla Foundation is one of those infrastructures inherently unprofitable, unattractive, not price competent on individual level?
In spain you used to pay a canon/fee for every disk, hdd, or pendrive that can contain pirateed content, it's like a preemptive tax for everyone.
lol...
Like with motorways and much of other public infrastructure, competition is basically impossible (and would be too inefficient) due to the sheer scale of the project, and letting a for-profit run it would be nothing but harmful to the public.
I asked a question about the CEO & management soon after they announced the layoffs and the post had a few very good observations by others - then someone flagged the post and only my comments/responses.
Maybe she or her umpteen executives were on a mission to be busy lol.
You can see it here and some of the really good answers imo https://news.ycombinator.com/item?id=24171030
You can donate to the Foundation, but you can only purchase products from the Corporation: Mozilla VPN (https://vpn.mozilla.org/), Pocket Premium (https://getpocket.com/premium), and Firefox Private Network (https://fpn.firefox.com/). You can't donate to the Corporation.
I would also assume that there are conferences, grants/sponsorship/stipends, CEO pay, etc.
The audited report lists conferences/conventions meetings and advertising/promotion, two items that some may not want to contribute to.
I'm making no judgement regarding whether these expenses make sense or not, just pointing out something that someone who wants to finance Firefox and MDN may not want to contribute to.
Of course, unless you trust the organization to actually honor the intent behind a donation for a specific purpose, such donations are moot as long as the organization receives enough general-purpose donations: They can just put 100% of the money tied to a specific purpose behind that purpose, but reduce the amount of "general-purpose" money that would otherwise have gone to that purpose by the same amount.
Why? Misinformation is, this should have been proven by now, the greatest threat to democracy in recent history.
Browsers, social networks and search engines are the entry point into the web, they have to act with the responsibility that comes with this position (and yes I know neither Facebook nor Google have done a good job the last years).
This is why people don't donate to mozilla.
It is there in their annual report. In part it is what you are donating for. In a way it is MDN's mission
Edit: Unfortunately It appears that you can’t donate to MDN anymore because the “manage payments” page 404s.
It doesn't seem like it proved anything. It seems like barely anyone had an idea it existed.
Is it the most valuable contribution to Mozilla's mission?
> Our mission is to ensure the Internet is a global public resource, open and accessible to all. An Internet that truly puts people first, where individuals can shape their own experience and are empowered, safe and independent.
[0]: https://developer.mozilla.org/en-US/docs/MDN/MDN_Product_Adv...
[1]: https://blog.mozilla.org/blog/2017/10/18/mozilla-brings-micr...
So is that basically saying we're adding more work to a probably demoralized and overworked team?
My knowledge of Mozilla's internal hierarchy is admittedly quite sparse, what's the ratio of "beancounter" to "bread maker" with the recent cuts?
I don't think this changes their workload. The core engineering team is likely already responsible for technical improvements to and maintaining MDN.
- Sponsor for $ a month: https://developer.mozilla.org/en-US/payments/
- Buy Merch: https://shop.spreadshirt.com/mdn-store/
That is not strange. Non-profits require good leadership - and that comes with a salary.
Sounds like they're planning to basically hand MDN over to either an independent foundation or consortium setup just for it, or let MS/Google take stewardship (Apple prominently but perhaps unsurprisingly missing from the Advisory board)...
Whatever happens I hope the docs are not left to languish outdated and progressively less useful. MDN is literally the wikipedia for web developers.
I also don't see why efforts can't be made to monetise the site with contextual ads. Hosting reasonable ads is better than simply dying off for lack of self sufficiency. If the issue is because of ties to the non-profit foundation then changes can be made...
In terms of who will add content, we still have our tech writers contributing. But the current volume of content across the site will be lower.
My personal opinion is that whilst MDN has an amazing community of people who write for it, it needs a permanent staff to ensure the reference materials are suitable for developers. I want our team to work out how we can get back to having a permanent staff to support MDN and have that staff be agnostic to browser vendors.
Then, the paid version would be the most convenient and attractive to anyone with $5 a month to spare, but everyone else could get access through the nearest library or university, a one-time hassle with equivalent access after.
As a bonus it raises awareness and usage of libraries, which is good for everyone.
Another example - browser compatibility matrices. They could be free just for the current versions of browsers and you'd have to pay for historical and future (i.e. development versions) data.
I think it's possible to find a balance between making the essential knowledge free so newcomers can join the industry and charging those who already have a source of income. I know that 5$/month can still be too much in some parts of the world, but this could be addressed with regional pricing.
Looks like they won't write new content themselves, but will have a system for keeping content up to date
I've long avoided w3schools, but a lot of comments on various HN threads suggest the site has improved a lot over the past few years. If true, this makes me less worried about the future of MDN.
Plus there's other reference sites I find myself using from time to time, for instance Can I Use[1] (which has a Patreon) and QuirksMode[2] (supported by donations). Monocultures, in my view, are not good for the environment - and that includes coding reference sites.
[1] - https://caniuse.com/
> We recognize that our tech writing staff drive a great deal of value to MDN users, as do partner contributions to the content. So we are working on a plan to keep the content up to date.
The stated rationale for the "re-org" (read, layoffs) was to shore up the financials and explore new revenue opportunities. Here is a novel idea that I will provide at no cost:
Charge for access to MDN, structure the legal particulars so that revenue goes to pay the tech writing staff, covers operating costs, and provides the excess to the Mozilla Foundation. Use the resulting goodwill and attention as a lead generation mechanism for whatever other projects Mozilla tries to create and charge for.
Market validation you say? People won't pay for documentation you say? The sole developer of the macOS app Dash[1] makes a fairly decent living selling an app that merely allows you to search freely available documentation offline. MDN has real value that people, myself included, will pay for. Just this week I have referred to MDN documentation at least a couple of hundred times.
Charge. Money. For. MDN.
And pay the tech writers.
Edit: wording correction.
- Sponsor for $ a month: https://developer.mozilla.org/en-US/payments/
- Buy Merch: https://shop.spreadshirt.com/mdn-store/
Competent organizations would pay for this in bulk.
Perhaps there should be a more direct way for people and organizations to contribute money to the docs (or a paid App or other value add) but the docs themselves shouldn't be closed off.
It doesn't have to. The content could remain out in the open.
Although you are correct in that I am suggesting a paywall there are other ways this could work:
- Subscribers could set MDN project priorities in terms of which technologies get focus, topic expansion, expanded example code, etc.
- Early access to incomplete documentation could be given to subscribers.
- Issues with documentation or example code coming from subscribers could get priority treatment.
- Offline versions of the documentation could be subscriber exclusive.
The bottom line is that a tragedy of the commons situation needs to be avoided. Is a paywall really worse than letting bit-rot settle in on the existing MDN content?
There's no need to lockout the poor teenagers who are wanting to explore web tech for themselves.
My build on this: Mozilla, send out a poll and see if this is something people would thrown down $$$ for.
I'm pretty sure a "good enough" alternative would pickup the visibility, such as w3schools, and many won't be able to justify the expense of there isn't some kind of exclusivity.
(there could be some sort of member/sponsor program, but having tried to run those, they have alot of overhead)
- Sponsor for $ a month: https://developer.mozilla.org/en-US/payments/
- Buy Merch: https://shop.spreadshirt.com/mdn-store/
As an example , Wikipedia is used much more than MDN docs as everybody in the world can find something useful on Wikipedia but MDN docs appeal only to web developers . Yet every year; Wikipedia has a hard time gathering donations to run their site with a skeletal crew and they have to resort to huge banner messages exhorting users to donate.
Mozilla's contract with google was just renewed, and is roughly the same amount of money they were making before. COVID had essentially no impact on their finances, and this is all corporate PR bullshit.
- Oh, but not if I have to use Paypal
- Oh, but not if I have to use a credit card
- Oh, but not if I have to use a trackable payment system
- Bitcoin is trackable, Monero or never
- So I have to go through KYC just to pay Mozilla? No fucking way
- 100% of the money should go to tech writers
- Money is fungible, so how do I know they aren't just taking out other money to send this there
- Ever since Pocket, I've changed my mind
- Ever since Brendan Eich, I've changed my mind
- How is it fair that both the tech writer who wrote 20% of the content and the new guy get the same amount from donations?
- If DevTools isn't included there's no point
- If DevTools is included there's no point
And then, in the end, one guy gives like $5/month because he wants to prove to himself that he was honest.
In fact, I'll tell you what: if 50 people reply to this comment pledging $60/yr ($5/month), I'll have someone set up a GoFundMe with a goal of $120k/year to fund one technical writer full time (and his associated payroll taxes etc.). I'll match that with $5k of my own money and I'll handle full comms with Mozilla to try to get them to hire someone. So validation is 2.5% of the final sum. Show me.
EDIT: By the way if it hits 50 many days after (when I won't be notified), my email is in my profile if you want to prod.
Skip to the point and set up a patron , as a node dev I would not able to do my job without MDN.
god, I _wish_
There was no path toward that number without moving to what were considered "technical" roles on other teams, including when I moved into a tools development role within the tech writing team.
So I wish I, or anyone I've worked with, or any full-time technical writer I've ever spoken to, got that level of compensation for technical writing. I'd still be doing it if I'd gotten paid that much.
I'm not saying nobody gets paid that, someone probably does or I'm sure y'all wouldn't talk about it. But god I _wish_ I'd ever actually seen it, just to know it was out there.
Mozilla is sitting on $500M cash reserves + $500M / year from Google. Don't assign lack of money as the real reason of MDN falling: lack of product direction and leadership.
If you really love MDN or whatever then why not fork it and pay for hosting its competitor. Just import all the pages to Mediawiki and put it up online.
As a freelance frontend developer, you only have to calculate how little you have to work to get this $60/year. So it's a no-brainer for such a valuable resource as MDN
Love MDN, it's absolutely been some of the most valuable documentation I've been privileged to have access to during my career.
But also, for the 1st part, LOL! (IMO, HN needs to learn to laugh at itself from time-to-time.)
And also, for the 2nd part, thank you for organizing this. Because I'm bootstrapping for my retirement fund, I'm not particularly flush for cash, and so too often I'm a freeloader. This is great though - I hope you get it together.
One final thought is that Mozilla executives don't really deserve to be the custodians of MDN anymore, and so perhaps as a community we need to be looking for ways to liberate MDN from Mozilla. For example, the technical writer, rather than being a Mozilla employee, could be an independent MDN contributor collaborating with Mozillla employees, and contributing under CC-BY-SA 2.5. [0]
Whatever financial/operational reasons there were for the recent cutbacks, the current situation of MDN (and Firefox) confirms my doubt and distrust of the leadership and management. It's been terrible for their reputation.
Of course, as a for-profit, they're free to prioritize business and financial sustainability. But the decisions they implemented - and how they went about it - seemed to have no respect for what makes Mozilla actually valuable (not just in terms of profit, but in social good and long-term role in the market).
They should have started by eliminating the bloat from the top, instead of laying off hard-working teams, experts and specialists that produced the real value.
In the end, if these projects can adapt and survive, it might turn out to be a good thing, to become more community-supported and independent of Mozilla. On the other hand, it seems natural for Google or Microsoft to swoop in as "evangelists of the open web" and take these projects under their (massively funded) wings.
Sure, put up another barrier for those trying to learn web development.
I get your point, in a perfect world folks like you might land a nice job and kick back 10k as a thanks. Unfortunately, that doesn't happen, so alternatives are necessary.
It will just end up like the news sites with a paywall - "oh the want me to pay <clicks back and goes to next search result while moaning about why Google even includes these paywall sites in results>
I bet I am not alone - it is just a reference and any other site can cobble together some examples that 99% of visitors just want to copy-paste anyway so they can get back to their work or fix that weird error (e.g. w3schools)
There are also questions in my mind about who would pay: the industry veteran who remembers the days before we had developer tools, or the person just starting out who doesn't really know anything yet? Or someone else? Neither the veteran or the newbie would get much value out of that $5 in my mind, leaving only a hollow rump of the middle-ground of people who care enough to pay for access, but also don't care enough to learn so that they won't actually need the subscription?
It doesn't make sense. MDN will drop down the search rankings and some other site will provide reference material for DOM + JavaScript.
This doesn't sit very well with me, as someone who has written a few security-related articles on MDN and generally tries to contribute to e.g. the compat-data repository as I get time. I'm motivated, just as I would be with an OSS PR, by the work being high quality and freely accessible to all.
It's a wiki. Anyone can help contribute. Do the professional technical writers do an excellent job as changes land in Firefox? Yes. Is it fair to charge for access to contributions that both the paid technical writers and the community have contributed under the impression that this is a free resource in the public domain? I'm not sure.
Is there a middle ground whereby we can still fund hosting/maintenance/professional technical writing but give access to a) folks who perhaps otherwise wouldn't have the means to pay for the documentation and b) folks who've contributed to the resource? Perhaps.
Some commercial model would be ideal, but having a paywall would mean that the influence of MDN on the large web developer community will become than much smaller.
That would mean less developers having easy access to information that would help create write solid, browser-agnostic websites and applications. Which will be a loss for everyone.
Except, perhaps, for Google and the Chrome team, as the makers of the currently dominant web browser.
Why is that lawyer still there after 20 years of terrible decisions?
It seems like it suffers from a free rider problem which isn't at all helped by the lack of focus (and funds) in Mozilla's initiatives. I understand that people are sick of corporate greed, out-of-touch execs, etc but I don't blame Mozilla for deprioritizing it when they literally are running out of money to pay staff (this is a whole other issue in and of itself).
It should be spun out with formalised its goals then go full wikipedia with annual fundraising or donation drives. If this fails they should look to be subsumed under similar non-profit foundations who can afford to maintain it. The free rider problem is not easily solved and if it isn't I expect MDN to decay, there isn't away around this.
No. Developers are supposed to pay to access the hard work of the technical writers and developers who maintain MDN. I don't understand why you think it's self-evident that this work should be free.
Here is a longer explanation by the person who created the precursor to MDN: https://www.quirksmode.org/blog/archives/2020/08/i_love_mdn_...
Here is the HN thread: https://news.ycombinator.com/item?id=24159244
I lead of Chrome DevRel team and we contribute with tech writer support and work on the PAB, it appears too little still but there are many web standards aligned companies that could provide more support because they directly benefit from MDNs existence.
- Sponsor for $ a month: https://developer.mozilla.org/en-US/payments/
- Buy Merch: https://shop.spreadshirt.com/mdn-store/
Source: I'm Chinese.
Right now mozilla is very much beholden to the whims of the their CEO and has been for a while (when interim-CEO and before that when Mozilla Foundation chairwoman). Baker - additionally to being the current CEO of the Corporation - chairs the board of directors of both, the Foundation and the Corporation. The current Mozilla Foundation president, Surman, is her long-time yes-man, as well. Chris Beard, former CEO taking reign after Eich's departure - was a Baker yes-man as well.
She managed to surround herself with an army of yes-people. She effectively is a "(benevolent) dictator" like a SV billionaire would be, except the billionaire probably wouldn't spend so much mozilla money on themself and their cronies.
To be fair, Baker played an instrumental role in getting Netscape to release the initial code and setting up the Foundation, and was a good steward of the Foundation for a long time.
She played a bit of a role in what started the downfall of mozilla (peaking at burning stacks on money on FirefoxOS; tho some good work came out of it that, it's still a huge net negative), but it was mostly other people who were a little bit... too enthusiastic about what mozilla can achieve, spreading resources thin.
After the failure of FirefoxOS, mozilla leadership got scared and clueless what to do next, and looked for Baker to provide leadership.
But Baker lacks the "product" vision (Firefox had to come from other people as a hobby project, even FirefoxOS started out that way), is more interested in pet projects and dominating them. E.g. the way the CoC was handled; I am not saying a CoC in itself is bad, but the way it was handled and communicated caused major rifts between the leadership and the volunteers, leading to a lot of especially the most experienced "valuable" volunteers shrugging and resigning and changing focus to other projects.
The Eich (and gerv) situation - which wasn't helped by Baker, to say it politely - furthermore created a talent vacuum at the top of the Corporation, and eventually was "resolved" by filing it with unsuited candidates - specifically Baker's yes-man Chris Beard, who was too much of a marketing guy and figurehead to be an effective leader in the CEO role. (I am not commenting on, analyzing or defending Eich's reasons for donating to Prop 8, which made same-sex marriages illegal in California until it was reversed by a court later)
Since the ousting of Eich, and even a little before that, it appears to me, the culture turned from a more or less productive "togetherness" (with it's share of clashes, of course) to an outright cold war between the Baker camp and many of the actual tech staff (and few remaining tech-centered managers). A lot of very good, very idealistic "true believer" people lost their faith and took the golden parachute to the FAANGS, something I would have never expected from a lot of them a few years earlier. Of course, priorities and opinions shift over the course of a life, and not everybody who left did so because of the situation at mozilla - some surely did to seek new challenges or advance their career - but it's still staggering to see the exodus of long-time believers, employees and volunteers alike, over the least 5 or so years.
I remember sitting in the audience of the 2013 mozilla summit (Eich hadn't left mozilla yet, of course) and seeing the constant stream of the leadership talk about "changing the world", "1 million mozillians", proclaiming how "FirefoxOS and BrowserID" will empower users, and all that moonshooting marketing stuff. I distinctly remember the negative impression Baker and Pete Scanlon left me with. And I remember the extreme overuse of the word "Awesome". I remember looking left and right to my fellow (mostly volunteer) pals, looking as confused as me, and that one Baker-friend (forgot her name) sitting rather close to us in the audience, constantly whooing and howling in approval. I remember talking to a lot of (new to me) people from all things mozilla during the summit, and most everybody was as confused as me, and far from being as excited and optimistic as the leadership had been, and very skeptical about the use of resources and leadership priorities. It was not my first big mozilla event, but it was the first one which had a Kafkaesque "corporate" "management decided" feel to it, instead of a community networking event of a diverse community working towards a common goal.
https://developers.google.com/web/fundamentals from Google, at least they have a lot of experience building valuable user-facing at-scale sites.
Microsoft has done more relevant open source and developer stuff in the last half decade.
So fucking work out that plan before this announcement. Corporate culture makes me wanna vomit.
Love how you creatively defined this concept. This is a recurring pattern i´ve seen particularly in tech, and its not just over billionaires..
In psychoanalysis theres this great lacanian concept of "Big Other".
Once i understood this concept better, its much easier to spot my own flaws on counting on the Big Other (that is actually some illusory tendency of our minds to give us some comfort and help us to cope with the brutal reality).
You can see a great fictional tale about this concept embodied in "The Wizard of Oz".
Once we understand that the big other we were always counting on is in fact pretty much "smoke and mirrors", and that the big other (unlike in the wizard tale) doesnt really care, its a sour wake up call, but one that makes you grow up a little.
And if you not only believe in Big Others, but also assume they have a good willing nature, especially the ones that followed a road paved with gold, i have a bridge to sell to you..
Mozilla corp-speak is so undecipherable that they leave a wake of panicked confusion with every one of these posts.
I just dropped Firefox. My way of punishing Mozilla for this stupid decision.