Use WGSL instead of GLSL in library documentation #2849
Labels
area: documentation
Documentation for crate items, public or private
good first issue
Good for newcomers
help required
We need community help to make this happen.
type: enhancement
New feature or request
There are a number of items in
wgpu
whose documentation contain examples using GLSL syntax or other references to GLSL elements. Since WGSL is now the standard shading language for WebGPU, it would be beneficial to readers if these examples were presented first in WGSL. (Keeping the GLSL would still be helpful for new users arriving from WebGL.)Relevant occurrences of the text "GLSL" in documentation as of commit c36eb9f (just after 0.13.1):
Features::SAMPLED_TEXTURE_AND_STORAGE_BUFFER_ARRAY_NON_UNIFORM_INDEXING
Features::UNIFORM_BUFFER_AND_STORAGE_TEXTURE_ARRAY_NON_UNIFORM_INDEXING
BufferBindingType
BindingType
StorageTextureAccess
TextureSampleType
TextureViewDimension
Incomplete list (since it's hard to search for) of locations where the documentation refers to GLSL entities without even mentioning GLSL:
PipelineLayoutDescriptor
refers to "set = 0" which is GLSL syntax.BindingType::Texture::multisampled
refers to GLSL texture sampling functions.Features::TEXTURE_BINDING_ARRAY
andBUFFER_BINDING_ARRAY
have GLSL examples.Also possibly of interest: the following items mention something like “See the OpenGL specification” but are not about shading language per se and are mostly just declining to explain a topic:
BlendFactor
BlendState
BindingType::StorageTexture
SamplerBindingType
The text was updated successfully, but these errors were encountered: