Provide minimal example?

[Vipitis]

This is somewhat of a proposal, to discuss it a bit.

The triangle and cube examples are the most basic examples we provide. But they are also a bit convoluted because they serve as utilities that can be reused elsewhere.

Now it's not too difficult to serialize the functions in your head(and skip all the asycnc variants), or when you copy these as a starting point. But for beginners it might add some amount of confusion. And those are the most viewed documents in the repository.

I propose adding a standalone example like triangle_minimal and perhaps port one more complex example from https://webgpu.github.io/webgpu-samples/ to python.

Let me know what you think, or if you have any suggestions. I can open a PR for this sometime this week.

[Korijn]

I feel the same way!

[hmaarrfk]

I felt so confused trying to use the examples as a starting point.

Their modularity confused me to no end.

in my opinion: the simplest triangle example should have the simplest name triangle.py

I know it’s really tempting to try to add “one more knob “ on an example to keep trying to reuse it. I’ve been very guilty of this.

[Korijn]

The problem is that now people will get confused about other things, like how do I make this work with GUI toolkit X, window library Y, etc...

Either way, let's just do it :)

[almarklein]

Yeah let's make triangle.py super-simple. IIRC the cube.py is modular so we can keep that to re-use in other examples.