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_A…
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/