Possible Typo in WebGPU documentation

[iampi31415]

MDN URL

https://developer.mozilla.org/en-US/docs/Web/API/GPUCommandEncoder

What specific section or headline is this issue about?

https://developer.mozilla.org/en-US/docs/Web/API/GPUCommandEncoder#examples

What information was incorrect, unhelpful, or incomplete?

Quoting, but bold is mine:

The commands encoded by the GPUCommandEncoder are recoded into a GPUCommandBuffer using the GPUCommandEncoder.finish() method.

(If it really meant recoded it would be useful to know what is meant in this context.)

---

I'd also comment that the initial description:

The GPUCommandEncoder interface of the WebGPU API represents a command encoder, used to encode commands to be issued to the GPU.

Is in my view too vague. We know that .finish() puts them into a command buffer, but what does encoding mean here? Translating to Native API commands?

What did you expect to see?

Should be recorded or maybe stored, unless I misinterpret.

(If it really meant recoded it would be useful to know what is meant in this context.)

Do you have any supporting links, references, or citations?

No response

Do you have anything more you want to share?

❤

MDN metadata

Page report details

• Folder: en-us/web/api/gpucommandencoder
• MDN URL: https://developer.mozilla.org/en-US/docs/Web/API/GPUCommandEncoder
• GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/web/api/gpucommandencoder/index.md
• Last commit: 08e04f1
• Document last modified: 2024-11-25T22:12:07.000Z

[Josh-Cena]

@chrisdavidmills could you advise?

[chrisdavidmills]

Hi @iampi31415! Thanks for filing this. Some responses:

1. Yes, "recoded" should be "recorded" ;-)
2. Encoding is the terminology the spec uses, and I think you are on the right path when you say "Translating to Native API commands" — you use API commands to tell the browser what you want to do, and it translates those into native API commands to give to the platform GPU in the background.