diff --git a/webgpu.h b/webgpu.h
index fc2b46b..aafe4b1 100644
--- a/webgpu.h
+++ b/webgpu.h
@@ -1408,7 +1408,11 @@ typedef void (*WGPUCreateRenderPipelineAsyncCallback)(WGPUCreatePipelineAsyncSta
  * (2) The last ref of the device has been (or is being) released: see @ref DeviceRelease.
  * This parameter is @ref PassedWithoutOwnership.
  *
+ * @param reason
+ * An error code explaining why the device was lost.
+ *
  * @param message
+ * A @ref LocalizableHumanReadableMessageString describing why the device was lost.
  * This parameter is @ref PassedWithoutOwnership.
  */
 typedef void (*WGPUDeviceLostCallback)(WGPUDevice const * device, WGPUDeviceLostReason reason, WGPUStringView message, WGPU_NULLABLE void* userdata1, WGPU_NULLABLE void* userdata2) WGPU_FUNCTION_ATTRIBUTE;
@@ -5938,6 +5942,9 @@ WGPU_EXPORT WGPUBufferMapState wgpuBufferGetMapState(WGPUBuffer buffer) WGPU_FUN
 WGPU_EXPORT uint64_t wgpuBufferGetSize(WGPUBuffer buffer) WGPU_FUNCTION_ATTRIBUTE;
 WGPU_EXPORT WGPUBufferUsage wgpuBufferGetUsage(WGPUBuffer buffer) WGPU_FUNCTION_ATTRIBUTE;
 /**
+ * @param mode
+ * The mapping mode (read or write).
+ *
  * @param offset
  * Byte offset relative to beginning of the buffer.
  *
diff --git a/webgpu.json b/webgpu.json
index 5f5b90e..06ee90f 100644
--- a/webgpu.json
+++ b/webgpu.json
@@ -253,12 +253,12 @@
           "type": "object.device"
         },
         {
-          "doc": "TODO\n",
+          "doc": "An error code explaining why the device was lost.\n",
           "name": "reason",
           "type": "enum.device_lost_reason"
         },
         {
-          "doc": "TODO\n",
+          "doc": "A @ref LocalizableHumanReadableMessageString describing why the device was lost.\n",
           "name": "message",
           "passed_with_ownership": false,
           "type": "out_string"
@@ -2581,7 +2581,7 @@
         {
           "args": [
             {
-              "doc": "TODO\n",
+              "doc": "The mapping mode (read or write).\n",
               "name": "mode",
               "type": "bitflag.map_mode"
             },
diff --git a/webgpu.yml b/webgpu.yml
index 4eaa664..83cab9e 100644
--- a/webgpu.yml
+++ b/webgpu.yml
@@ -3485,11 +3485,11 @@ callbacks:
         passed_with_ownership: false
       - name: reason
         doc: |
-          TODO
+          An error code explaining why the device was lost.
         type: enum.device_lost_reason
       - name: message
         doc: |
-          TODO
+          A @ref LocalizableHumanReadableMessageString describing why the device was lost.
         type: out_string
         passed_with_ownership: false
   - name: pop_error_scope
@@ -3735,7 +3735,7 @@ objects:
         args:
           - name: mode
             doc: |
-              TODO
+              The mapping mode (read or write).
             type: bitflag.map_mode
           - name: offset
             doc: |