MDN converted to Markdown
openwebdocs.org
MDN converted to Markdown
1–10 of 140 posts
Re: MDN converted to Markdown
#2Oh man a markdown local copy of MDN would be fantastic!
Re: MDN converted to Markdown
#3Oh man a markdown local copy of MDN would be fantastic!
+1. Just to be able to regex search!
Re: MDN converted to Markdown
#4Oh man a markdown local copy of MDN would be fantastic!
https://devdocs.io/offline
works great!
Re: MDN converted to Markdown
#5Oh man a markdown local copy of MDN would be fantastic!
I dream to be able to use the mdn/content repo directly on GitHub. Unfortunately the Markdown links are the "production" site ones and don't work in GitHub. It would be nice to have links that work there and their toolchain (called Yari if I understand well) should translate it when generating the MDN site.
It would allow for easier reuse of the content.
Re: MDN converted to Markdown
#6It's too bad that AsciiDoc still hasn't really caught on like Markdown. It's a whole lot nicer for more-complicated documents. I understand their reasons for not using it here, but it still seems like a perfect fit for this task. Eclipse still seems to be working on a formal spec, but hopefully that will help implementations to grow and adoption to increase.
In any case, avoiding raw HTML is a huge improvement. I like this document. It's well written, and it provides a clear explanation for every major technical decision made on the way.
Re: MDN converted to Markdown
#7Oh man a markdown local copy of MDN would be fantastic!
install zeal for offline docs including mdn
Re: MDN converted to Markdown
#8It's too bad that AsciiDoc still hasn't really caught on like Markdown. It's a whole lot nicer for more-complicated documents. I understand their reasons for not using it here, but it still seems like a perfect fit for this task. Eclipse still seems to be working on a formal spec, but hopefully that will help implementations to grow and adoption to increase. In any case, avoiding raw HTML is a huge improvement. I lik…
Markdown is "worse is better". AsciiDoc is more powerful, but has a steeper learning curve, therefore it lost.
tale as old as tech.
EDIT: i'm compiling a list of "Worse is Better" technology battles:
- Mixed paradigm languages vs Functional languages
- Typescript vs Flow
- React+Redux beat Angular and Elm
- VHS beat Betamax
- AC beat DC
- what else? please share more here https://hashnode.com/preview/636602dec7fec996b85c7165 (draft!)
Re: MDN converted to Markdown
#9> We might have gone on for another year or two with HTML-format documentation, and it would just have been a drag on our productivity. But we knew that this wasn't a sustainable foundation in the long term
Really? It was HTML for 17 years with over 11,000 pages. But I guess that’s not long-term sustainability?
I applaud the conversion, but don’t misrepresent the facts and what you inherited, Wil.
Re: MDN converted to Markdown
#10Oh man a markdown local copy of MDN would be fantastic!
It is already there.