Issue #18761 has been updated by rubyFeedback (robert heiler).

need more getting started instructions?

I think it may be helpful if there would be something like a "mini-tutorial", in the sense that you could go from a super simple use case (hello world), towards something that is a bit more useful (something like tic-tac-toe, in the browser, or even just something simpler, like a mini-calculator), to a tiny bit more advanced (but not too overly complicated). Right now the documentation only has "Create and save index.html page with the following contents", but even when you do this, and then load it into your browser, you don't see anything happening. So something is missing. This may be super-trivial for WASM folks who already understand how this works, but for anyone new to the topic, it kind of means that you need to go to another language if you want to understand how this all works right now. Which is unfortunate, because it may be that WASM works well, but this is not shown to others how this can be done, because there is sparsely any documentation.

You can find pre-compiled wasm files on GitHub: https://github.com/ruby/ruby.wasm/releases

The problem here is that the README at https://github.com/ruby/ruby.wasm does not really explain what one can do with this. It seems as if this is all geared more towards advanced users. Interestingly, I checked python + WASM, and the documentation it shows here: https://pythondev.readthedocs.io/wasm.html Is also very, very bad. I don't know why the WASM documentation is in general so bad. The only exception here is mozilla, which actually has a very decent documentation here: https://developer.mozilla.org/en-US/docs/WebAssembly/Using_the_JavaScript_AP... So it is a bit as if one has to read these other websites first (such as the mozilla one) before being able to dive into the ruby-wasm or python-wasm aspect of it. ---------------------------------------- Misc #18761: provide an example wasm project https://bugs.ruby-lang.org/issues/18761#change-101984 * Author: grosser (Michael Grosser) * Status: Open * Priority: Normal * Assignee: katei (Yuta Saito) ---------------------------------------- Neither the release notes nor the wasm/README.md include any runnable examples. Please provide a docker image that can be used to generate a wasm binary (even if it's just "hello world"), to show how this is supposed to work. -- https://bugs.ruby-lang.org/