TypeScript-DOM-lib-generator
TypeScript-DOM-lib-generator copied to clipboard
Decide what to do with comments
Currently there are two ways to fetch comments
- From MDN
- From specs
Both are not being actively maintained. I think either one should be dropped and replaced by another one.
FYI: It looks like the fetch-comment and fetch-mdn scripts are now both broken.
-
fetch-commentrequiresinputfiles/idlSources.json, which was removed in #1044. -
fetch-mdnrequiresinputfiles/browser.webidl.preprocessed.json, which was removed in #1034. -
fetch-mdntries to fetch JSON files from MDN using the URL templatehttps://developer.mozilla.org/en-US/docs/Web/API/${name}$json(where${name}is the name of an IDL interface), but this no longer works. For example,https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream$jsonreturns HTTP 404. There doesn't seem to be an official machine-friendly API anymore... 😕 The best we can do would be processing the Markdown source files from https://github.com/mdn/content, such as https://github.com/mdn/content/blob/main/files/en-us/web/api/readablestream/index.md.
Safari DevTools seemingly imports comments for CSS properties from somewhere, not sure it's MDN or not. I hope there's a better way since both of the previous ways were all hacky.