Conversation
|
I think the double warning is good. That's two separate things to have attention drawn to. |
|
Do you think the warning icon is appropriate here? It's probably fine, although I wonder if it might make sense to try to make it look less like the deprecation warning, which is what it's currently borrowed from. Something maybe more inviting (different colour coding?) could be good, although this is probably a fine starting point too. |
|
While a jigsaw-piece icon or building-blocks icon could signify an add-on (if there's not an icon in use for that yet, the warning icon already best says to a lot of readers: "Hey! Watch out, this code probably isn't going to work for you unless X", and is easily the best for getting people's attention so that they avoid frustration and wasted time. |
I've started writing some experimental compute shader reference docs in processing/p5.js#8531. WebGPU docs are a little different from regular ones because you need to include an extra addon script. They're a little like p5.sound in that sense, but unlike p5.sound, which has its own reference page to itself, that will probably not be the case for WebGPU; instead, they will likely be mixed in with other categories, like p5.strands.
So this PR:
custom:devscript to also copy over the webgpu addon from the branch it builds fromwebgpu?: booleanproperty of reference data, which will indicate that the item will need the WebGPU script in its exampleswebgpuOnly?: booleanproperty of reference data, which will indicate that the item is only available in the WebGPU addon. (e.g. some examples ofmodel()may use webgpu, but the method itself doesn't need the addon;buildComputeShaderneeds the webgpu addon.)Here's a preview:

The double-warning of experimental + webgpu isn't super great UI, let me know if anyone has ideas on how to make that nicer!