Stream: wasm

Topic: mdn wasm documentation


view this post on Zulip Robin Brown (Jul 04 2022 at 14:49):

There's an MDN discussion going on about how much and what kind of documentation MDN should have for WASM. If anyone here has thoughts they should go chime in.
https://github.com/mdn/content/discussions/17826

I fully believe that MDN should document the WebAssembly APIs/interfaces/etc. for JavaScript; no question there. Instead, I am concerned with pages like these: /docs/WebAssembly/Understanding_the_t...

view this post on Zulip Dan Gohman (Jul 06 2022 at 00:38):

On one hand, documenting the core WebAssembly language in detail on MDN would have value for at least some people. The official spec is written by experts for other experts, and deliberately excludes examples, illustrations, and introductory content. There's space for more broadly approachable documentation.

view this post on Zulip Dan Gohman (Jul 06 2022 at 00:39):

On the other, documentation needs to be maintained, and WebAssembly will be evolving a lot over the next few years, and I'm not in a position to judge whether the amount of maintenance work this kind of documentation would entail would be worth it for MDN.


Last updated: Dec 23 2024 at 12:05 UTC