API documentation js.html lost about html-externs

[aduros]

Yeah, it didn't make it for 3.2. Some of the generated docs were badly formatted, or just plain wrong.

Maintaining docs by hand would be way too much work. I wonder if there's a machine readable doc source out there that we can use.

[markknol]

I contacted a MDN contributor, he told me this

So, IDLs differ from browser to browser and there are usually no docs in them.
MDN is quite structured, but it is a wiki so not perfectly structured.
We are making progress to be more and more structured, so that tools and consume our content.
So, maybe you can't embed all the information from MDN today, but you can certainly link to many of them.
The URL is always the same: https://developer.mozilla.org/en-US/docs/Web/API/

For embedding, there are URLs like this

• https://developer.mozilla.org/en-US/docs/Web/API/AbstractWorker?raw&macros&section=Example
  where "Example" is a headline in the article.
• https://developer.mozilla.org/en-US/docs/Web/API/AbstractWorker
• https://developer.mozilla.org/en-US/docs/Web/API/Document?raw
• https://developer.mozilla.org/en-US/docs/Web/API/Document?raw&section=Methods

See https://developer.mozilla.org/en-US/docs/MDN/Contribute/Tools/Document_parameters for more info

Is this something we can use ? It would be nice if we can scrape the content out of this and use it as documentation.