From ed55855db374a64cfd71c6539e660a1b9ab0d852 Mon Sep 17 00:00:00 2001
From: Luke Curley <kixelated@gmail.com>
Date: Tue, 20 Oct 2026 12:59:23 -0700
Subject: [PATCH 1/5] chore: claim bindings documentation quest

Co-Authored-By: GPT-6 <noreply@openai.com>

From d901092838ff5874fe0abd870ac3e6fd838a159d Mon Sep 17 00:00:00 2001
From: Luke Curley <kixelated@gmail.com>
Date: Tue, 20 Oct 2026 13:13:20 -0700
Subject: [PATCH 2/5] docs(bindings): document the public Rust and C surfaces

Co-Authored-By: GPT-6 <noreply@openai.com>
---
 go/wrapper/errors.go                          |   2 +-
 .../kotlin/dev/moq/audio/Audio.kt             |   2 +-
 quest/m1/README.md                            |   1 -
 quest/m1/docs-bindings.md                     |  22 ---
 rs/moq-c/src/api.rs                           |  63 ++++++++
 rs/moq-c/src/audio.rs                         |  27 +++-
 rs/moq-c/src/error.rs                         |  39 +++++
 rs/moq-c/src/lib.rs                           |   2 +
 rs/moq-c/src/video.rs                         |  11 ++
 rs/moq-ffi/src/audio.rs                       |  19 ++-
 rs/moq-ffi/src/consumer.rs                    |  17 ++-
 rs/moq-ffi/src/error.rs                       | 134 +++++++++++++++---
 rs/moq-ffi/src/lib.rs                         |   1 +
 rs/moq-ffi/src/media.rs                       |  52 ++++++-
 rs/moq-ffi/src/origin.rs                      |  25 +++-
 rs/moq-ffi/src/producer.rs                    |   6 +
 rs/moq-ffi/src/server.rs                      |   2 +
 rs/moq-ffi/src/session.rs                     |   3 +
 rs/moq-ffi/src/video.rs                       |  17 ++-
 swift/Sources/Moq/Aliases.swift               |   2 +-
 20 files changed, 379 insertions(+), 68 deletions(-)
 delete mode 100644 quest/m1/docs-bindings.md

diff --git a/go/wrapper/errors.go b/go/wrapper/errors.go
index fb6df76c5cb..2dfb8be0d63 100644
--- a/go/wrapper/errors.go
+++ b/go/wrapper/errors.go
@@ -41,7 +41,7 @@ var (
 	ErrVideo = ffi.ErrMoqErrorVideo
 	// ErrURL matches a malformed URL passed when connecting or publishing.
 	ErrURL = ffi.ErrMoqErrorUrl
-	// ErrTimeOverflow matches a timestamp that overflowed its timescale.
+	// ErrTimeOverflow matches a timestamp outside the supported range.
 	ErrTimeOverflow = ffi.ErrMoqErrorTimeOverflow
 	// ErrLogLevel matches an unparseable log level string passed to LogLevel.
 	ErrLogLevel = ffi.ErrMoqErrorLogLevel
diff --git a/kt/moq/src/jvmAndAndroidMain/kotlin/dev/moq/audio/Audio.kt b/kt/moq/src/jvmAndAndroidMain/kotlin/dev/moq/audio/Audio.kt
index ac9e6d37e16..bbead7c43fc 100644
--- a/kt/moq/src/jvmAndAndroidMain/kotlin/dev/moq/audio/Audio.kt
+++ b/kt/moq/src/jvmAndAndroidMain/kotlin/dev/moq/audio/Audio.kt
@@ -12,7 +12,7 @@ typealias EncoderInput = uniffi.moq.MoqAudioEncoderInput
 typealias EncoderOutput = uniffi.moq.MoqAudioEncoderOutput
 /** The PCM layout a [Consumer] delivers, how stale a group may get, and its playout delay. */
 typealias DecoderOutput = uniffi.moq.MoqAudioDecoderOutput
-/** Interleaved PCM with its presentation timestamp. */
+/** PCM samples in the configured layout with their presentation timestamp. */
 typealias Frame = uniffi.moq.MoqAudioFrame
 /** One encoded payload from an [Encoder]. */
 typealias Packet = uniffi.moq.MoqAudioPacket
diff --git a/quest/m1/README.md b/quest/m1/README.md
index 0520ca02390..2a5a1191b11 100644
--- a/quest/m1/README.md
+++ b/quest/m1/README.md
@@ -118,7 +118,6 @@ lands before the cut.
 - [lite-06 max sequence](/quest/m1/lite06-max-sequence.md) - group sequence 2^62-1 reaches a lite-06 subscriber or is refused loudly, instead of vanishing
 - [Track live signal](/quest/m1/track-live.md) - a reader can wait for its track's feed to be live, so a player skips old cached groups while a fresh upstream subscription starts
 - [moq-mux docs](/quest/m1/docs-mux.md) - every public moq-mux item has rustdoc and the crate warns on missing docs
-- [Binding docs](/quest/m1/docs-bindings.md) - every public moq-ffi and moq-c item has rustdoc, carried into the generated bindings and `moq.h`
 - [JS export docs](/quest/m1/docs-js.md) - every public JS export and class member has TSDoc, and `just check` enforces it
 
 - [C++ and OBS package proof](/quest/m1/cpp-package-check.md) - the installed artifacts pass before their first release
diff --git a/quest/m1/docs-bindings.md b/quest/m1/docs-bindings.md
deleted file mode 100644
index c89a595def3..00000000000
--- a/quest/m1/docs-bindings.md
+++ /dev/null
@@ -1,22 +0,0 @@
-# [M] Document the moq-ffi and moq-c APIs
-
-## Goal
-
-Every public item in `moq-ffi` and `moq-c` has a one-line rustdoc, so the
-generated bindings and `moq.h` carry it, and both crates set
-`#![warn(missing_docs)]`.
-
-## Plan
-
-The m0 documentation audit (2026-10-19) found 116 undocumented public items
-in `moq-ffi` (42 in `error.rs`, the rest across `media`, `audio`, `origin`,
-`video`, and the producer and consumer types) and 133 in `moq-c` (39 in
-`error.rs`, 63 in `api.rs`, plus `audio` and `video`). Error codes and
-variants make up most of it.
-
-Count them with `cargo rustdoc -p <crate> --lib --all-features -- -W
-missing_docs`. Check that the docs reach the outputs a binding user reads:
-UniFFI copies rustdoc into the generated Python, Swift, Kotlin, and Go code,
-and cbindgen copies it into `moq.h`. The hand-written wrappers listed in the
-Cross-Package Sync table keep their own docs; align them where they restate
-the same item.
diff --git a/rs/moq-c/src/api.rs b/rs/moq-c/src/api.rs
index 7948ed0c53e..d0dd5b11642 100644
--- a/rs/moq-c/src/api.rs
+++ b/rs/moq-c/src/api.rs
@@ -44,6 +44,7 @@ pub struct moq_container {
 	/// The CMAF init segment (ftyp+moov), or NULL.
 	/// Read only when `kind` is `MOQ_CONTAINER_KIND_CMAF`, where it is required.
 	pub init: *const u8,
+	/// The length in bytes of `init`.
 	pub init_len: usize,
 }
 
@@ -321,10 +322,12 @@ fn container_format_from_u32(value: u32) -> Result<moq_mux::import::ContainerFor
 pub struct moq_video_config {
 	/// The name of the track, NOT NULL terminated.
 	pub name: *const c_char,
+	/// The length in bytes of `name`.
 	pub name_len: usize,
 
 	/// The codec of the track, NOT NULL terminated
 	pub codec: *const c_char,
+	/// The length in bytes of `codec`.
 	pub codec_len: usize,
 
 	/// The description of the track, or NULL if not used.
@@ -332,12 +335,14 @@ pub struct moq_video_config {
 	///   - NULL: annex.b encoded
 	///   - Non-NULL: AVCC encoded
 	pub description: *const u8,
+	/// The length in bytes of `description`.
 	pub description_len: usize,
 
 	/// The encoded width/height of the media, a hint so a decoder can size its
 	/// buffers up front. Zero means absent, which no valid dimension is, so the
 	/// two are independent: a catalog carrying only one round-trips unchanged.
 	pub coded_width: u32,
+	/// The encoded height in pixels, or zero when absent.
 	pub coded_height: u32,
 
 	/// How the track's frames are wrapped.
@@ -384,14 +389,17 @@ pub struct moq_video_properties {
 pub struct moq_audio_config {
 	/// The name of the track, NOT NULL terminated
 	pub name: *const c_char,
+	/// The length in bytes of `name`.
 	pub name_len: usize,
 
 	/// The codec of the track, NOT NULL terminated
 	pub codec: *const c_char,
+	/// The length in bytes of `codec`.
 	pub codec_len: usize,
 
 	/// The description of the track, or NULL if not used.
 	pub description: *const u8,
+	/// The length in bytes of `description`.
 	pub description_len: usize,
 
 	/// The sample rate of the track in Hz
@@ -455,6 +463,7 @@ pub struct moq_binary_config {
 pub struct moq_json_value {
 	/// The JSON document as UTF-8, NOT NULL terminated.
 	pub json: *const c_char,
+	/// The length in bytes of `json`.
 	pub json_len: usize,
 
 	/// The timestamp of the frame that carried the value in microseconds, or 0 when
@@ -472,6 +481,7 @@ pub struct moq_json_value {
 pub struct moq_frame {
 	/// The payload of the frame, or NULL/0 if the stream has ended
 	pub payload: *const u8,
+	/// The length in bytes of `payload`.
 	pub payload_size: usize,
 
 	/// The presentation timestamp of the frame in microseconds, or 0 when
@@ -492,6 +502,7 @@ pub struct moq_frame {
 pub struct moq_datagram {
 	/// The payload of the datagram, or NULL/0 if the track has ended.
 	pub payload: *const u8,
+	/// The length in bytes of `payload`.
 	pub payload_size: usize,
 
 	/// The presentation timestamp of the datagram in microseconds, or 0 when
@@ -593,6 +604,7 @@ pub struct moq_subscription {
 	/// A request to the publisher, aggregated across every subscriber. Reads start at the
 	/// lowest group a range starts at, and stop past the last absolute end.
 	pub ranges: *const moq_range,
+	/// The number of entries in `ranges`.
 	pub ranges_len: usize,
 
 	/// `moq_order` discriminant: which pending group the publisher sends first.
@@ -707,6 +719,7 @@ pub(crate) unsafe fn parse_subscription(
 pub struct moq_string {
 	/// Pointer to `len` bytes of UTF-8, NOT NULL terminated.
 	pub data: *const c_char,
+	/// The string length in bytes.
 	pub len: usize,
 }
 
@@ -721,10 +734,12 @@ pub struct moq_string {
 pub struct moq_section {
 	/// The section name, NOT NULL terminated.
 	pub name: *const c_char,
+	/// The length in bytes of `name`.
 	pub name_len: usize,
 
 	/// The section value as a JSON document, NOT NULL terminated.
 	pub json: *const c_char,
+	/// The length in bytes of `json`.
 	pub json_len: usize,
 }
 
@@ -742,6 +757,7 @@ pub struct moq_route {
 	/// Hop ids, oldest first. NULL when `hops_len` is 0. 0 is the anonymous
 	/// mark and is legal on a received chain.
 	pub hops: *const u64,
+	/// The number of entries in `hops`.
 	pub hops_len: usize,
 	/// Preference among routes covering the same prefix: lower wins.
 	pub cost: u64,
@@ -796,11 +812,13 @@ unsafe fn parse_route(route: *const moq_route) -> Result<moq_net::origin::Route,
 pub struct moq_announce_config {
 	/// A literal path root, NOT NULL terminated. NULL when `prefix_len` is 0.
 	pub prefix: *const c_char,
+	/// The length in bytes of `prefix`.
 	pub prefix_len: usize,
 
 	/// A pattern relative to `prefix`, NOT NULL terminated, or NULL for every
 	/// path beneath it. Empty is a valid exact filter.
 	pub filter: *const c_char,
+	/// The length in bytes of `filter`.
 	pub filter_len: usize,
 
 	/// Also list hidden paths: those with a segment starting with `.` below the prefix.
@@ -829,13 +847,16 @@ pub enum moq_announce_kind {
 pub struct moq_announce_event {
 	/// The covered prefix, relative to the origin, NOT NULL terminated
 	pub prefix: *const c_char,
+	/// The length in bytes of `prefix`.
 	pub prefix_len: usize,
 
 	/// What each requested filter wildcard matched. Each string is NOT NULL terminated.
 	/// Meaningful only when `has_captures` is true; false means the route overlaps
 	/// the filter without pinning every wildcard.
 	pub captures: *const moq_string,
+	/// The number of entries in `captures`.
 	pub captures_len: usize,
+	/// Whether `captures` is present.
 	pub has_captures: bool,
 
 	/// Which event this is.
@@ -863,34 +884,42 @@ pub struct moq_connection_snapshot {
 pub struct moq_connection_stats {
 	/// Smoothed round-trip time, in microseconds.
 	pub rtt_us: u64,
+	/// Whether `rtt_us` is available in this sample.
 	pub rtt_valid: bool,
 
 	/// Estimated send bandwidth from the congestion controller, in bits per second.
 	pub estimated_send_rate_bps: u64,
+	/// Whether `estimated_send_rate_bps` is available in this sample.
 	pub estimated_send_rate_valid: bool,
 
 	/// Total bytes sent, including retransmissions and overhead.
 	pub bytes_sent: u64,
+	/// Whether `bytes_sent` is available in this sample.
 	pub bytes_sent_valid: bool,
 
 	/// Total bytes received, including duplicates and overhead.
 	pub bytes_received: u64,
+	/// Whether `bytes_received` is available in this sample.
 	pub bytes_received_valid: bool,
 
 	/// Total bytes lost (detected via retransmission or acknowledgement).
 	pub bytes_lost: u64,
+	/// Whether `bytes_lost` is available in this sample.
 	pub bytes_lost_valid: bool,
 
 	/// Total datagrams sent.
 	pub packets_sent: u64,
+	/// Whether `packets_sent` is available in this sample.
 	pub packets_sent_valid: bool,
 
 	/// Total datagrams received.
 	pub packets_received: u64,
+	/// Whether `packets_received` is available in this sample.
 	pub packets_received_valid: bool,
 
 	/// Total datagrams detected as lost.
 	pub packets_lost: u64,
+	/// Whether `packets_lost` is available in this sample.
 	pub packets_lost_valid: bool,
 }
 
@@ -1069,31 +1098,38 @@ pub struct moq_client_config {
 	/// the CLI spells them (`moq-lite-05`, `moq-transport-22`); [moq_versions]
 	/// lists what is on offer.
 	pub versions: *const moq_string,
+	/// The number of entries in `versions`.
 	pub versions_len: usize,
 
 	/// Local socket address to bind, or NULL for the wildcard address.
 	pub bind: *const c_char,
+	/// The length in bytes of `bind`.
 	pub bind_len: usize,
 
 	/// How long a dial may take before it gives up.
 	pub connect_timeout_us: u64,
+	/// Whether `connect_timeout_us` is present.
 	pub has_connect_timeout: bool,
 
 	/// Happy Eyeballs: how long before the next address is also dialed.
 	pub failover_delay_us: u64,
+	/// Whether `failover_delay_us` is present.
 	pub has_failover_delay: bool,
 
 	/// Happy Eyeballs: how long the first family waits for the AAAA answer.
 	pub resolution_delay_us: u64,
+	/// Whether `resolution_delay_us` is present.
 	pub has_resolution_delay: bool,
 
 	/// Whether the WebSocket fallback may be raced, for a UDP-blocked network.
 	/// Enabled unless you turn it off, hence the flag.
 	pub websocket_enabled: bool,
+	/// Whether `websocket_enabled` is present.
 	pub has_websocket_enabled: bool,
 
 	/// How long QUIC gets before the WebSocket fallback is also dialed.
 	pub websocket_delay_us: u64,
+	/// Whether `websocket_delay_us` is present.
 	pub has_websocket_delay: bool,
 
 	/// Accept any certificate. Development only: prefer `tls_fingerprints`,
@@ -1103,60 +1139,83 @@ pub struct moq_client_config {
 	/// Whether to trust the platform root store. Its default depends on the
 	/// backend, so it needs the flag to distinguish "off" from "unset".
 	pub tls_system_roots: bool,
+	/// Whether `tls_system_roots` is present.
 	pub has_tls_system_roots: bool,
 
 	/// Extra root certificate paths to trust.
 	pub tls_roots: *const moq_string,
+	/// The number of entries in `tls_roots`.
 	pub tls_roots_len: usize,
 
 	/// SHA-256 certificate fingerprints to pin, hex encoded. The native
 	/// equivalent of the browser's `serverCertificateHashes`.
 	pub tls_fingerprints: *const moq_string,
+	/// The number of entries in `tls_fingerprints`.
 	pub tls_fingerprints_len: usize,
 
 	/// SNI override, or NULL to use the host from the URL.
 	pub tls_host_name: *const c_char,
+	/// The length in bytes of `tls_host_name`.
 	pub tls_host_name_len: usize,
 
 	/// Client certificate and key paths for mTLS, or NULL for none.
 	pub tls_cert: *const c_char,
+	/// The length in bytes of `tls_cert`.
 	pub tls_cert_len: usize,
+	/// The client private key path for mTLS, or NULL for none.
 	pub tls_key: *const c_char,
+	/// The length in bytes of `tls_key`.
 	pub tls_key_len: usize,
 
 	/// Reconnect pacing. Each must leave a non-zero delay or retrying would
 	/// spin, which is rejected at dial.
 	pub backoff_initial_us: u64,
+	/// Whether `backoff_initial_us` is present.
 	pub has_backoff_initial: bool,
+	/// The factor by which the reconnect delay increases.
 	pub backoff_multiplier: u32,
+	/// Whether `backoff_multiplier` is present.
 	pub has_backoff_multiplier: bool,
+	/// The maximum reconnect delay in microseconds.
 	pub backoff_max_us: u64,
+	/// Whether `backoff_max_us` is present.
 	pub has_backoff_max: bool,
 	/// How long reconnection keeps trying before giving up for good.
 	pub backoff_timeout_us: u64,
+	/// Whether `backoff_timeout_us` is present.
 	pub has_backoff_timeout: bool,
 
 	/// QUIC transport tuning, all ignored by the WebSocket fallback.
 	pub quic_max_streams: u64,
+	/// Whether `quic_max_streams` is present.
 	pub has_quic_max_streams: bool,
+	/// The QUIC idle timeout in microseconds.
 	pub quic_idle_timeout_us: u64,
+	/// Whether `quic_idle_timeout_us` is present.
 	pub has_quic_idle_timeout: bool,
+	/// The QUIC keep-alive interval in microseconds.
 	pub quic_keep_alive_us: u64,
+	/// Whether `quic_keep_alive_us` is present.
 	pub has_quic_keep_alive: bool,
 	/// Generic segmentation offload and path MTU discovery. Both default to the
 	/// backend's choice, so both need their flag.
 	pub quic_gso: bool,
+	/// Whether `quic_gso` is present.
 	pub has_quic_gso: bool,
+	/// Whether QUIC may discover the path MTU.
 	pub quic_mtu_discovery: bool,
+	/// Whether `quic_mtu_discovery` is present.
 	pub has_quic_mtu_discovery: bool,
 
 	/// Congestion control family name (`loss`, `delay`, or `none`), or NULL for the backend's choice.
 	pub quic_congestion_control: *const c_char,
+	/// The length in bytes of `quic_congestion_control`.
 	pub quic_congestion_control_len: usize,
 
 	/// Directory to write qlog traces into, or NULL for none. Capture is
 	/// compile-time optional; see [moq_qlog_supported].
 	pub quic_qlog: *const c_char,
+	/// The length in bytes of `quic_qlog`.
 	pub quic_qlog_len: usize,
 
 	/// Danger: write TLS session secrets to the file `SSLKEYLOGFILE` names, for
@@ -1437,19 +1496,23 @@ pub struct moq_server_config {
 	/// Address to bind, e.g. `[::]:443`, `127.0.0.1:0`, or `localhost:4443`; NULL
 	/// for `[::]:443`. A port of 0 picks one; read it back with [moq_server_addr].
 	pub bind: *const c_char,
+	/// The length in bytes of `bind`.
 	pub bind_len: usize,
 
 	/// Certificate chain paths (PEM), paired with `tls_key`.
 	pub tls_cert: *const moq_string,
+	/// The number of entries in `tls_cert`.
 	pub tls_cert_len: usize,
 
 	/// Private key paths (PEM), paired with `tls_cert`.
 	pub tls_key: *const moq_string,
+	/// The number of entries in `tls_key`.
 	pub tls_key_len: usize,
 
 	/// Hostnames to generate a self-signed certificate for. Clients must pin its
 	/// fingerprint ([moq_server_fingerprints]) or disable verification.
 	pub tls_generate: *const moq_string,
+	/// The number of entries in `tls_generate`.
 	pub tls_generate_len: usize,
 
 	/// Danger: write TLS session secrets to the file `SSLKEYLOGFILE` names, for
diff --git a/rs/moq-c/src/audio.rs b/rs/moq-c/src/audio.rs
index 89b004f34e7..6bd963c3185 100644
--- a/rs/moq-c/src/audio.rs
+++ b/rs/moq-c/src/audio.rs
@@ -36,13 +36,21 @@ use crate::{Error, Id, NonZeroSlab, Shared, State, ffi};
 #[allow(non_camel_case_types)]
 #[derive(Clone, Copy, Debug)]
 pub enum moq_audio_sample_format {
+	/// Unsigned 8-bit PCM samples, interleaved by channel.
 	MOQ_AUDIO_SAMPLE_FORMAT_U8 = 0,
+	/// Signed 16-bit PCM samples, interleaved by channel.
 	MOQ_AUDIO_SAMPLE_FORMAT_S16 = 1,
+	/// Signed 32-bit PCM samples, interleaved by channel.
 	MOQ_AUDIO_SAMPLE_FORMAT_S32 = 2,
+	/// 32-bit floating-point PCM samples, interleaved by channel.
 	MOQ_AUDIO_SAMPLE_FORMAT_F32 = 3,
+	/// Unsigned 8-bit PCM samples, one plane per channel.
 	MOQ_AUDIO_SAMPLE_FORMAT_U8_PLANAR = 4,
+	/// Signed 16-bit PCM samples, one plane per channel.
 	MOQ_AUDIO_SAMPLE_FORMAT_S16_PLANAR = 5,
+	/// Signed 32-bit PCM samples, one plane per channel.
 	MOQ_AUDIO_SAMPLE_FORMAT_S32_PLANAR = 6,
+	/// 32-bit floating-point PCM samples, one plane per channel.
 	MOQ_AUDIO_SAMPLE_FORMAT_F32_PLANAR = 7,
 }
 
@@ -67,8 +75,9 @@ fn audio_format_from_u32(value: u32) -> Result<moq_audio::Format, Error> {
 pub struct moq_audio_encoder_input {
 	/// `moq_audio_sample_format` discriminant.
 	pub format: u32,
+	/// The number of PCM samples per second.
 	pub sample_rate: u32,
-	/// Interleaved channel count, which also names the speaker layout by the
+	/// The channel count, which also names the speaker layout by the
 	/// WAVE convention: 1 mono, 2 stereo, 3 2.1, 4 quad, 5 5.0, 6 5.1, 7 6.1,
 	/// 8 7.1, in front left, front right, center, LFE, back, side order.
 	pub channels: u32,
@@ -83,6 +92,7 @@ pub struct moq_audio_encoder_output {
 	/// Codec id, UTF-8: "opus", "pcm", or "aac". AAC encodes through the
 	/// platform's encoder, so a host without one refuses it.
 	pub codec: *const c_char,
+	/// The length in bytes of `codec`.
 	pub codec_len: usize,
 	/// 0 = derive from input.
 	pub sample_rate: u32,
@@ -100,6 +110,7 @@ pub struct moq_audio_encoder_output {
 #[repr(C)]
 #[allow(non_camel_case_types)]
 pub struct moq_audio_decoder_output {
+	/// The moq_audio_sample_format discriminant.
 	pub format: u32,
 	/// 0 = deliver at the codec's native sample rate.
 	pub sample_rate: u32,
@@ -111,9 +122,8 @@ pub struct moq_audio_decoder_output {
 	/// microseconds. Same congestion-control knob as
 	/// `moq_consume_audio`'s `max_delay_us`. 0 = skip
 	/// aggressively (the moq-mux default); set to your playout
-	/// buffer (tens to a few hundred ms) for a softer skip. Named
-	/// `_max` to leave room for a future `min_buffer_us`, a
-	/// jitter-buffer floor rather than a staleness bound.
+	/// buffer (tens to a few hundred ms) for a softer skip. This bounds
+	/// group staleness rather than setting a minimum playout delay.
 	pub max_delay_us: u64,
 }
 
@@ -125,8 +135,11 @@ pub struct moq_audio_decoder_output {
 #[repr(C)]
 #[allow(non_camel_case_types)]
 pub struct moq_audio_frame {
+	/// The presentation timestamp in microseconds.
 	pub timestamp_us: u64,
+	/// The raw frame bytes in the configured layout.
 	pub data: *const u8,
+	/// The length in bytes of `data`.
 	pub data_size: usize,
 }
 
@@ -142,6 +155,7 @@ pub(crate) struct AudioEncoder {
 type AudioProducer = Shared<AudioEncoder>;
 
 #[derive(Default)]
+/// The audio encoder, decoder, and decoded frame handle tables.
 pub struct Audio {
 	producers: NonZeroSlab<AudioProducer>,
 	consumer_tasks: NonZeroSlab<Task>,
@@ -149,6 +163,7 @@ pub struct Audio {
 }
 
 impl Audio {
+	/// Encode PCM frames into an audio track and return its handle.
 	pub fn publish(
 		&mut self,
 		broadcast: &mut moq_net::broadcast::Producer,
@@ -199,6 +214,7 @@ impl Audio {
 		self.producers.remove(id).ok_or(Error::MediaNotFound)
 	}
 
+	/// Decode a rendition and deliver frame handles to the callback.
 	pub fn consume(
 		&mut self,
 		rendition: crate::consume::Rendition<hang::catalog::AudioConfig>,
@@ -259,10 +275,12 @@ impl Audio {
 		}
 	}
 
+	/// Stop decoding and release the consumer handle.
 	pub fn consume_close(&mut self, id: Id) -> Result<(), Error> {
 		self.consumer_tasks.close(id, Error::TrackNotFound)
 	}
 
+	/// Borrow a decoded frame and its metadata until its handle is freed.
 	pub fn frame_info(&self, id: Id, dst: &mut moq_audio_frame) -> Result<(), Error> {
 		let frame = self.frames.get(id).ok_or(Error::FrameNotFound)?;
 		*dst = moq_audio_frame {
@@ -277,6 +295,7 @@ impl Audio {
 		Ok(())
 	}
 
+	/// Release a decoded frame handle.
 	pub fn frame_free(&mut self, id: Id) -> Result<(), Error> {
 		self.frames.remove(id).ok_or(Error::FrameNotFound)?;
 		Ok(())
diff --git a/rs/moq-c/src/error.rs b/rs/moq-c/src/error.rs
index 4b6c8d4c4f0..75d7eb3d58d 100644
--- a/rs/moq-c/src/error.rs
+++ b/rs/moq-c/src/error.rs
@@ -4,44 +4,83 @@ use crate::ffi;
 
 // Keep these public constants as the single source for both Rust's return mapping and the
 // generated C header. -1, -11, -12, and -39 are retired and remain reserved.
+/// The MoQ protocol operation failed.
 pub const MOQ_ERROR_MOQ: i32 = -2;
+/// The URL could not be parsed.
 pub const MOQ_ERROR_URL: i32 = -3;
+/// The input is not valid UTF-8.
 pub const MOQ_ERROR_UTF8: i32 = -4;
+/// The connection could not be established.
 pub const MOQ_ERROR_CONNECT: i32 = -5;
+/// A required pointer is null or invalid.
 pub const MOQ_ERROR_INVALID_POINTER: i32 = -6;
+/// The resource handle is invalid.
 pub const MOQ_ERROR_INVALID_ID: i32 = -7;
+/// The requested resource was not found.
 pub const MOQ_ERROR_NOT_FOUND: i32 = -8;
+/// The media format is not recognized.
 pub const MOQ_ERROR_UNKNOWN_FORMAT: i32 = -9;
+/// Initialization failed.
 pub const MOQ_ERROR_INIT_FAILED: i32 = -10;
+/// The timestamp is outside the supported range.
 pub const MOQ_ERROR_TIMESTAMP_OVERFLOW: i32 = -13;
+/// The requested log level is invalid.
 pub const MOQ_ERROR_LEVEL: i32 = -14;
+/// The enum value or error code is invalid.
 pub const MOQ_ERROR_INVALID_CODE: i32 = -15;
+/// A Rust task panicked.
 pub const MOQ_ERROR_PANIC: i32 = -16;
+/// The origin is offline.
 pub const MOQ_ERROR_OFFLINE: i32 = -17;
+/// The media catalog or container could not be processed.
 pub const MOQ_ERROR_HANG: i32 = -18;
+/// The requested rendition index is out of range.
 pub const MOQ_ERROR_NO_INDEX: i32 = -19;
+/// A string contains an unexpected NUL byte.
 pub const MOQ_ERROR_NUL: i32 = -20;
+/// The session handle was not found.
 pub const MOQ_ERROR_SESSION_NOT_FOUND: i32 = -21;
+/// The origin handle was not found.
 pub const MOQ_ERROR_ORIGIN_NOT_FOUND: i32 = -22;
+/// The announcement handle was not found.
 pub const MOQ_ERROR_ANNOUNCEMENT_NOT_FOUND: i32 = -23;
+/// The broadcast handle was not found.
 pub const MOQ_ERROR_BROADCAST_NOT_FOUND: i32 = -24;
+/// The catalog handle was not found.
 pub const MOQ_ERROR_CATALOG_NOT_FOUND: i32 = -25;
+/// The media handle was not found.
 pub const MOQ_ERROR_MEDIA_NOT_FOUND: i32 = -26;
+/// The track handle was not found.
 pub const MOQ_ERROR_TRACK_NOT_FOUND: i32 = -27;
+/// The frame handle was not found.
 pub const MOQ_ERROR_FRAME_NOT_FOUND: i32 = -28;
+/// Media could not be imported or exported.
 pub const MOQ_ERROR_MUX: i32 = -29;
+/// An audio codec operation failed.
 pub const MOQ_ERROR_AUDIO: i32 = -30;
+/// The importer did not consume the complete input buffer.
 pub const MOQ_ERROR_BUFFER_NOT_CONSUMED: i32 = -31;
+/// The group handle was not found.
 pub const MOQ_ERROR_GROUP_NOT_FOUND: i32 = -32;
+/// The native transport helper failed.
 pub const MOQ_ERROR_NATIVE: i32 = -33;
+/// Authorization is required or invalid.
 pub const MOQ_ERROR_UNAUTHORIZED: i32 = -34;
+/// Authorization does not permit the requested operation.
 pub const MOQ_ERROR_FORBIDDEN: i32 = -35;
+/// A video codec operation failed.
 pub const MOQ_ERROR_VIDEO: i32 = -36;
+/// JSON could not be parsed or encoded.
 pub const MOQ_ERROR_JSON: i32 = -37;
+/// A JSON track could not be processed.
 pub const MOQ_ERROR_JSON_TRACK: i32 = -38;
+/// The configuration contains an invalid value.
 pub const MOQ_ERROR_INVALID_CONFIG: i32 = -40;
+/// A standalone consumer cannot resolve a rendition in another broadcast.
 pub const MOQ_ERROR_UNRESOLVABLE_BROADCAST: i32 = -41;
+/// The authorization token expired.
 pub const MOQ_ERROR_EXPIRED: i32 = -42;
+/// The catalog requires a newer moq-hang version than this build supports.
 pub const MOQ_ERROR_UNSUPPORTED_CATALOG: i32 = -43;
 
 /// Whether a protocol code is from the session or stream registry.
diff --git a/rs/moq-c/src/lib.rs b/rs/moq-c/src/lib.rs
index 453b298ad98..c249cc994e5 100644
--- a/rs/moq-c/src/lib.rs
+++ b/rs/moq-c/src/lib.rs
@@ -1,3 +1,5 @@
+#![warn(missing_docs)]
+
 //! C bindings for [`moq_net`].
 //!
 //! Provides a C-compatible API for real-time pub/sub over QUIC.
diff --git a/rs/moq-c/src/video.rs b/rs/moq-c/src/video.rs
index 7d09c680796..b433bfac278 100644
--- a/rs/moq-c/src/video.rs
+++ b/rs/moq-c/src/video.rs
@@ -106,6 +106,7 @@ pub struct moq_video_encoder_output {
 	/// Backend name, UTF-8, e.g. `"videotoolbox"`, `"nvenc"`, `"mediafoundation"`,
 	/// `"openh264"`. Read only when `kind` is `MOQ_VIDEO_ENCODER_KIND_NAMED`.
 	pub encoder: *const c_char,
+	/// The length in bytes of `encoder`.
 	pub encoder_len: usize,
 }
 
@@ -121,7 +122,9 @@ pub struct moq_video_encoder_output {
 pub struct moq_video_encoder_frame {
 	/// Presentation timestamp, in microseconds.
 	pub timestamp_us: u64,
+	/// The raw frame bytes in the configured layout.
 	pub data: *const u8,
+	/// The length in bytes of `data`.
 	pub data_size: usize,
 }
 
@@ -169,10 +172,15 @@ pub struct moq_video_decoder_output {
 #[repr(C)]
 #[allow(non_camel_case_types)]
 pub struct moq_video_frame {
+	/// The presentation timestamp in microseconds.
 	pub timestamp_us: u64,
+	/// The decoded width in pixels.
 	pub width: u32,
+	/// The decoded height in pixels.
 	pub height: u32,
+	/// The raw frame bytes in the configured layout.
 	pub data: *const u8,
+	/// The length in bytes of `data`.
 	pub data_size: usize,
 }
 
@@ -521,6 +529,7 @@ impl Video {
 		self.producers.remove(id).ok_or(Error::MediaNotFound)
 	}
 
+	/// Decode a rendition and deliver frame handles to the callback.
 	pub fn consume(
 		&mut self,
 		rendition: crate::consume::Rendition<hang::catalog::VideoConfig>,
@@ -578,6 +587,7 @@ impl Video {
 		}
 	}
 
+	/// Stop decoding and release the consumer handle.
 	pub fn consume_close(&mut self, id: Id) -> Result<(), Error> {
 		self.consumer_tasks.close(id, Error::TrackNotFound)
 	}
@@ -588,6 +598,7 @@ impl Video {
 		self.frames.get(id).cloned().ok_or(Error::FrameNotFound)
 	}
 
+	/// Release a decoded frame handle.
 	pub fn frame_free(&mut self, id: Id) -> Result<(), Error> {
 		self.frames.remove(id).ok_or(Error::FrameNotFound)?;
 		Ok(())
diff --git a/rs/moq-ffi/src/audio.rs b/rs/moq-ffi/src/audio.rs
index d91929fba5d..d8c21270775 100644
--- a/rs/moq-ffi/src/audio.rs
+++ b/rs/moq-ffi/src/audio.rs
@@ -20,13 +20,21 @@ use crate::ffi::Task;
 /// <https://developer.mozilla.org/en-US/docs/Web/API/AudioData/format>
 #[derive(Clone, Copy, uniffi::Enum)]
 pub enum MoqAudioSampleFormat {
+	/// Unsigned 8-bit PCM samples, interleaved by channel.
 	U8,
+	/// Signed 16-bit PCM samples, interleaved by channel.
 	S16,
+	/// Signed 32-bit PCM samples, interleaved by channel.
 	S32,
+	/// 32-bit floating-point PCM samples, interleaved by channel.
 	F32,
+	/// Unsigned 8-bit PCM samples, one plane per channel.
 	U8Planar,
+	/// Signed 16-bit PCM samples, one plane per channel.
 	S16Planar,
+	/// Signed 32-bit PCM samples, one plane per channel.
 	S32Planar,
+	/// 32-bit floating-point PCM samples, one plane per channel.
 	F32Planar,
 }
 
@@ -106,9 +114,11 @@ impl From<MoqAudioPreset> for moq_audio::encode::Preset {
 /// PCM layout the caller will pass to [`MoqAudioProducer::write`].
 #[derive(uniffi::Record)]
 pub struct MoqAudioEncoderInput {
+	/// The raw PCM sample layout.
 	pub format: MoqAudioSampleFormat,
+	/// The number of samples per second.
 	pub sample_rate: u32,
-	/// Interleaved channel count, which also names the speaker layout by the
+	/// The channel count, which also names the speaker layout by the
 	/// WAVE convention: 1 mono, 2 stereo, 3 2.1, 4 quad, 5 5.0, 6 5.1, 7 6.1,
 	/// 8 7.1, in front left, front right, center, LFE, back, side order.
 	pub channels: u32,
@@ -119,14 +129,18 @@ pub struct MoqAudioEncoderInput {
 /// value if necessary)".
 #[derive(uniffi::Record)]
 pub struct MoqAudioEncoderOutput {
+	/// The codec used to encode this rendition.
 	pub codec: Arc<MoqAudioCodec>,
 	/// Track name for a broadcast-bound producer. `None` derives one from the codec.
 	#[uniffi(default = None)]
 	pub track: Option<String>,
+	/// The encoded samples per second, or absent to match the input rate.
 	#[uniffi(default = None)]
 	pub sample_rate: Option<u32>,
+	/// The encoded channel count, or absent to match the input.
 	#[uniffi(default = None)]
 	pub channels: Option<u32>,
+	/// The target bitrate in bits per second, or absent for the codec default.
 	#[uniffi(default = None)]
 	pub bitrate: Option<u32>,
 	/// Encoded frame duration in microseconds. Opus accepts exactly
@@ -161,6 +175,7 @@ impl MoqAudioEncoderOutput {
 /// PCM layout the caller wants out of [`MoqAudioConsumer::next`].
 #[derive(uniffi::Record)]
 pub struct MoqAudioDecoderOutput {
+	/// The raw PCM sample layout.
 	pub format: MoqAudioSampleFormat,
 	/// `None` delivers samples at the codec's native rate.
 	#[uniffi(default = None)]
@@ -379,6 +394,7 @@ impl MoqAudioProducer {
 		Ok(())
 	}
 
+	/// Encode and publish one PCM frame.
 	pub fn write(&self, frame: MoqAudioFrame) -> Result<(), MoqError> {
 		let _guard = crate::ffi::runtime().enter();
 		let frame = moq_audio::Frame::try_from(frame)?;
@@ -395,6 +411,7 @@ impl MoqAudioProducer {
 		self.reservation.lock().unwrap().clone()
 	}
 
+	/// Drain the encoder and finish the audio track.
 	pub fn finish(&self) -> Result<(), MoqError> {
 		let _guard = crate::ffi::runtime().enter();
 		let mut producer = self.inner.lock().unwrap().take().ok_or(MoqError::Closed)?;
diff --git a/rs/moq-ffi/src/consumer.rs b/rs/moq-ffi/src/consumer.rs
index 728f08e1999..0cec6ea738c 100644
--- a/rs/moq-ffi/src/consumer.rs
+++ b/rs/moq-ffi/src/consumer.rs
@@ -1,3 +1,5 @@
+//! Read broadcasts, tracks, and groups.
+
 use std::future::Future;
 use std::sync::{Arc, Mutex};
 use std::task::{Poll, ready};
@@ -64,9 +66,17 @@ pub struct MoqRange {
 #[derive(Clone, Copy, uniffi::Enum)]
 pub enum MoqAnchor {
 	/// This exact group and frame.
-	Absolute { group: u64, frame: u64 },
+	Absolute {
+		/// The absolute group sequence number.
+		group: u64,
+		/// The zero-based frame index within the group.
+		frame: u64,
+	},
 	/// The group this many before the latest, clamped to group 0: `0` is the latest group.
-	Relative { groups: u64 },
+	Relative {
+		/// The number of groups back from the live edge.
+		groups: u64,
+	},
 }
 
 /// Which of a subscription's pending groups the publisher sends first, mirroring
@@ -142,6 +152,7 @@ impl From<MoqSubscription> for moq_net::track::Subscription {
 	}
 }
 
+/// A broadcast from which tracks and groups can be read.
 #[derive(Clone, uniffi::Object)]
 pub struct MoqBroadcastConsumer {
 	pub(crate) inner: moq_net::broadcast::Consumer,
@@ -501,6 +512,7 @@ async fn with_lane<R>(_lane: Guard<ReadLane>, fut: impl Future<Output = Result<R
 	fut.await
 }
 
+/// A subscribed track whose groups, frames, or datagrams can be read.
 #[derive(uniffi::Object)]
 pub struct MoqTrackConsumer {
 	shared: Arc<TrackShared>,
@@ -687,6 +699,7 @@ impl GroupInner {
 	}
 }
 
+/// A group whose frames can be read in order.
 #[derive(uniffi::Object)]
 pub struct MoqGroupConsumer {
 	sequence: u64,
diff --git a/rs/moq-ffi/src/error.rs b/rs/moq-ffi/src/error.rs
index 85f098f1d75..5fc89ceff14 100644
--- a/rs/moq-ffi/src/error.rs
+++ b/rs/moq-ffi/src/error.rs
@@ -167,54 +167,101 @@ fn stream_kind(err: &moq_net::StreamError) -> MoqProtocolKind {
 pub enum MoqError {
 	/// A protocol failure carrying the peer's session or stream code.
 	#[error("{details}")]
-	Protocol { details: MoqProtocolError },
+	Protocol {
+		/// The protocol registry, wire code, and diagnostic message.
+		details: MoqProtocolError,
+	},
 
 	/// The underlying QUIC/WebTransport connection failed.
 	#[error("transport: {reason}")]
-	Transport { reason: String },
+	Transport {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
 	/// A local failure without a session or stream code.
 	#[error("internal: {reason}")]
-	Internal { reason: String },
+	Internal {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
+	/// The media catalog or container could not be processed.
 	#[error("{reason}")]
-	Media { reason: String },
+	Media {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
+	/// Media could not be imported or exported.
 	#[error("{reason}")]
-	Mux { reason: String },
+	Mux {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
+	/// A JSON track could not be processed.
 	#[error("{reason}")]
-	JsonTrack { reason: String },
+	JsonTrack {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
 	// Native codec errors, behind the optional `audio`/`video` features.
+	/// An audio codec operation failed.
 	#[cfg(all(feature = "audio", not(target_arch = "wasm32")))]
 	#[error("{reason}")]
-	Audio { reason: String },
+	Audio {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
+	/// A video codec operation failed.
 	#[cfg(all(feature = "video", not(target_arch = "wasm32")))]
 	#[error("{reason}")]
-	Video { reason: String },
+	Video {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
+	/// The connection URL could not be parsed.
 	#[error("url: {reason}")]
-	Url { reason: String },
+	Url {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
+	/// A timestamp is outside the supported range.
 	#[error("timestamp overflow")]
 	TimeOverflow,
 
+	/// The requested log level is invalid.
 	#[error("log level: {reason}")]
-	LogLevel { reason: String },
+	LogLevel {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
 	/// An owned native task panicked; cancellation is reported separately.
 	#[cfg(not(target_arch = "wasm32"))]
 	#[error("task: {reason}")]
-	Task { reason: String },
+	Task {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
+	/// JSON could not be parsed or encoded.
 	#[error("json: {reason}")]
-	Json { reason: String },
+	Json {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
+	/// The operation was cancelled.
 	#[error("cancelled")]
 	Cancelled,
 
+	/// The handle or connection is closed.
 	#[error("closed")]
 	Closed,
 
@@ -225,24 +272,43 @@ pub enum MoqError {
 	#[error("busy")]
 	Busy,
 
+	/// A connection could not be established.
 	#[error("connect: {reason}")]
-	Connect { reason: String },
+	Connect {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
+	/// The local server socket could not be bound.
 	#[error("bind: {reason}")]
-	Bind { reason: String },
+	Bind {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
+	/// A connection was refused during the handshake.
 	#[error("reject: {reason}")]
-	Reject { reason: String },
+	Reject {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
+	/// The request has already been accepted or rejected.
 	#[error("already responded")]
 	AlreadyResponded,
 
+	/// Codec configuration or bitstream parsing failed.
 	#[error("codec: {reason}")]
-	Codec { reason: String },
+	Codec {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
+	/// Authorization is required or invalid.
 	#[error("unauthorized")]
 	Unauthorized,
 
+	/// Authorization does not permit the requested operation.
 	#[error("forbidden")]
 	Forbidden,
 
@@ -275,31 +341,53 @@ pub enum MoqError {
 
 	/// A route carried an invalid hop id or too many hops.
 	#[error("invalid route: {reason}")]
-	InvalidRoute { reason: String },
+	InvalidRoute {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
 	/// A path pattern was empty, had a doubled slash, or used a reserved segment form.
 	#[error("invalid pattern: {reason}")]
-	InvalidPattern { reason: String },
+	InvalidPattern {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
 	/// An epoch was not a lowercase hyphenated UUIDv7.
 	#[error("{reason}")]
-	InvalidEpoch { reason: String },
+	InvalidEpoch {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
 	/// A catalog rendition named another broadcast, but this consumer came from a standalone
 	/// broadcast rather than an origin, so there is nothing to resolve the reference against.
 	#[error("unresolvable broadcast reference: {reason}")]
-	UnresolvableBroadcast { reason: String },
+	UnresolvableBroadcast {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
+	/// The logger could not be initialized.
 	#[error("log: {reason}")]
-	Log { reason: String },
+	Log {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
 	/// A configuration record held a value the constructor cannot use.
 	#[error("config: {reason}")]
-	Config { reason: String },
+	Config {
+		/// A diagnostic message describing the failure.
+		reason: String,
+	},
 
 	/// A catalog needs a newer moq-hang draft than this build reads; upgrade to read it.
 	#[error("unsupported catalog version {version}")]
-	UnsupportedCatalog { version: u64 },
+	UnsupportedCatalog {
+		/// The catalog version this build cannot read.
+		version: u64,
+	},
 }
 
 impl From<moq_net::Error> for MoqError {
diff --git a/rs/moq-ffi/src/lib.rs b/rs/moq-ffi/src/lib.rs
index 5b741a8efce..0cc72dd72b0 100644
--- a/rs/moq-ffi/src/lib.rs
+++ b/rs/moq-ffi/src/lib.rs
@@ -1,3 +1,4 @@
+#![warn(missing_docs)]
 #![cfg_attr(test, allow(clippy::disallowed_methods))]
 
 //! UniFFI bindings for [`moq_net`].
diff --git a/rs/moq-ffi/src/media.rs b/rs/moq-ffi/src/media.rs
index 23e05fc6534..12d87e8f34b 100644
--- a/rs/moq-ffi/src/media.rs
+++ b/rs/moq-ffi/src/media.rs
@@ -1,3 +1,5 @@
+//! Publish and consume media catalogs and encoded frames.
+
 use std::collections::HashMap;
 use std::sync::{Arc, Weak};
 
@@ -15,7 +17,9 @@ use crate::producer::{MoqBroadcastProducer, MoqTrackRequest};
 /// A width and height in pixels.
 #[derive(Clone, uniffi::Record)]
 pub struct MoqDimensions {
+	/// The width in pixels.
 	pub width: u32,
+	/// The height in pixels.
 	pub height: u32,
 }
 
@@ -43,7 +47,10 @@ pub enum MoqContainer {
 	/// The legacy hang container.
 	Legacy,
 	/// CMAF (fMP4), carrying the initialization segment.
-	Cmaf { init: Vec<u8> },
+	Cmaf {
+		/// The CMAF initialization segment.
+		init: Vec<u8>,
+	},
 	/// LOC, the low-overhead container.
 	Loc,
 }
@@ -76,12 +83,18 @@ impl From<MoqContainer> for hang::catalog::Container {
 	}
 }
 
+/// A catalog snapshot describing the available media renditions.
 #[derive(uniffi::Record)]
 pub struct MoqCatalog {
+	/// Video renditions keyed by their catalog IDs.
 	pub video: HashMap<String, MoqVideo>,
+	/// Audio renditions keyed by their catalog IDs.
 	pub audio: HashMap<String, MoqAudio>,
+	/// The final rendered size after rotation, when specified.
 	pub display: Option<MoqDimensions>,
+	/// The clockwise rotation in degrees, when specified.
 	pub rotation: Option<f64>,
+	/// Whether to flip horizontally after rotation, when specified.
 	pub flip: Option<bool>,
 	/// Untyped application catalog sections, keyed by section name, each value a JSON string.
 	/// These are the top-level catalog keys beyond `video`/`audio`, carried through verbatim
@@ -90,6 +103,7 @@ pub struct MoqCatalog {
 	pub sections: HashMap<String, String>,
 }
 
+/// A video rendition and the configuration needed to decode it.
 #[derive(Clone, uniffi::Record)]
 pub struct MoqVideo {
 	/// Human-readable rendition name for track pickers.
@@ -103,20 +117,26 @@ pub struct MoqVideo {
 	/// the ID is the track name.
 	#[uniffi(default = None)]
 	pub track: Option<String>,
+	/// The codec string identifying this rendition's encoded format.
 	pub codec: String,
+	/// The codec initialization bytes, when required.
 	pub description: Option<Vec<u8>>,
 	/// The encoded pixel dimensions.
 	pub coded: Option<MoqDimensions>,
 	/// The aspect ratio the whole picture is displayed at; absent means the decoded shape.
 	pub display_aspect: Option<MoqDimensions>,
+	/// The maximum encoded bitrate in bits per second.
 	pub bitrate: Option<u64>,
 	/// Whether this rendition may be selected; when false, no frames are coming.
 	#[uniffi(default = true)]
 	pub enabled: bool,
+	/// The frame rate in frames per second, when specified.
 	pub framerate: Option<f64>,
+	/// The framing used to carry this rendition.
 	pub container: MoqContainer,
 }
 
+/// An audio rendition and the configuration needed to decode it.
 #[derive(Clone, uniffi::Record)]
 pub struct MoqAudio {
 	/// Human-readable rendition name for track pickers.
@@ -130,14 +150,20 @@ pub struct MoqAudio {
 	/// the ID is the track name.
 	#[uniffi(default = None)]
 	pub track: Option<String>,
+	/// The codec string identifying this rendition's encoded format.
 	pub codec: String,
+	/// The codec initialization bytes, when required.
 	pub description: Option<Vec<u8>>,
+	/// The number of samples per second.
 	pub sample_rate: u32,
+	/// The number of audio channels.
 	pub channel_count: u32,
+	/// The maximum encoded bitrate in bits per second.
 	pub bitrate: Option<u64>,
 	/// Whether this rendition may be selected; when false, no frames are coming.
 	#[uniffi(default = true)]
 	pub enabled: bool,
+	/// The framing used to carry this rendition.
 	pub container: MoqContainer,
 	/// The publisher's worst-case delay between a frame being ready and its flush, in
 	/// microseconds, which floors an estimated playout delay. Absent means frames flush at once.
@@ -603,9 +629,15 @@ mod test {
 #[derive(Clone, uniffi::Enum)]
 pub enum MoqMediaTarget {
 	/// A new track with an explicit name, or a unique name derived from its format.
-	Named { name: Option<String> },
+	Named {
+		/// The explicit track name, or absent to allocate a unique name from its format.
+		name: Option<String>,
+	},
 	/// A requested track whose name and ownership are already fixed.
-	Requested { request: Arc<MoqTrackRequest> },
+	Requested {
+		/// The pending track request to accept.
+		request: Arc<MoqTrackRequest>,
+	},
 }
 
 impl MoqMediaTarget {
@@ -1101,9 +1133,19 @@ fn reserve_track(
 #[derive(Clone, uniffi::Enum)]
 pub enum MoqRendition {
 	/// A video rendition.
-	Video { id: String, config: MoqVideo },
+	Video {
+		/// The rendition ID in the catalog.
+		id: String,
+		/// The rendition configuration.
+		config: MoqVideo,
+	},
 	/// An audio rendition.
-	Audio { id: String, config: MoqAudio },
+	Audio {
+		/// The rendition ID in the catalog.
+		id: String,
+		/// The rendition configuration.
+		config: MoqAudio,
+	},
 }
 
 impl MoqRendition {
diff --git a/rs/moq-ffi/src/origin.rs b/rs/moq-ffi/src/origin.rs
index d98f8f58f02..554b4919846 100644
--- a/rs/moq-ffi/src/origin.rs
+++ b/rs/moq-ffi/src/origin.rs
@@ -1,3 +1,5 @@
+//! Publish, discover, and route broadcasts.
+
 use std::sync::{Arc, Weak};
 
 use crate::consumer::MoqBroadcastConsumer;
@@ -112,6 +114,7 @@ pub fn moq_epoch_time_ms(epoch: String) -> Result<u64, MoqError> {
 	Ok(since.as_millis() as u64)
 }
 
+/// An origin in which broadcasts can be published.
 #[derive(uniffi::Object)]
 pub struct MoqOriginProducer {
 	inner: Origin,
@@ -130,12 +133,14 @@ impl std::ops::Deref for Origin {
 	}
 }
 
+/// An origin from which broadcasts can be discovered and requested.
 #[derive(uniffi::Object)]
 pub struct MoqOriginConsumer {
 	inner: moq_net::origin::Consumer,
 	pub(crate) driver: Background,
 }
 
+/// A stream of broadcast announcement changes.
 #[derive(uniffi::Object)]
 pub struct MoqAnnounceConsumer {
 	task: Task<Announced>,
@@ -317,14 +322,26 @@ impl From<moq_net::announce::Announce> for MoqAnnounce {
 #[derive(Clone, Debug, PartialEq, Eq, uniffi::Enum)]
 pub enum MoqAnnounceEvent {
 	/// A route now covers the prefix; the stream had none there.
-	Start { announce: MoqAnnounce },
+	Start {
+		/// The broadcast announcement affected by this event.
+		announce: MoqAnnounce,
+	},
 	/// The route covering the prefix changed hops or cost.
-	Update { announce: MoqAnnounce },
+	Update {
+		/// The broadcast announcement affected by this event.
+		announce: MoqAnnounce,
+	},
 	/// No route covers the prefix any more. Carries its last advertised route.
-	End { announce: MoqAnnounce },
+	End {
+		/// The broadcast announcement affected by this event.
+		announce: MoqAnnounce,
+	},
 	/// Another publisher instance now serves the prefix: drop what was resolved under
 	/// it and request afresh.
-	Restart { announce: MoqAnnounce },
+	Restart {
+		/// The broadcast announcement affected by this event.
+		announce: MoqAnnounce,
+	},
 }
 
 impl From<moq_net::announce::Event> for MoqAnnounceEvent {
diff --git a/rs/moq-ffi/src/producer.rs b/rs/moq-ffi/src/producer.rs
index e3468a11de4..36ad9ae934b 100644
--- a/rs/moq-ffi/src/producer.rs
+++ b/rs/moq-ffi/src/producer.rs
@@ -1,3 +1,5 @@
+//! Publish broadcasts, tracks, and groups.
+
 use std::sync::Arc;
 
 use moq_mux::catalog::hang::Extra;
@@ -91,11 +93,13 @@ pub(crate) struct BroadcastProducer {
 	pub(crate) driver: Background,
 }
 
+/// A broadcast in which tracks can be published.
 #[derive(uniffi::Object)]
 pub struct MoqBroadcastProducer {
 	pub(crate) state: std::sync::Mutex<Option<BroadcastProducer>>,
 }
 
+/// A handler for requests for tracks in a broadcast.
 #[derive(uniffi::Object)]
 pub struct MoqBroadcastDynamic {
 	task: Task<DynamicProducer>,
@@ -473,6 +477,7 @@ impl MoqTrackRequest {
 
 // ---- Track Producer ----
 
+/// A track to which groups, frames, or datagrams can be published.
 #[derive(uniffi::Object)]
 pub struct MoqTrackProducer {
 	inner: std::sync::Mutex<Option<moq_net::track::Producer>>,
@@ -623,6 +628,7 @@ impl MoqTrackProducer {
 	}
 }
 
+/// A group to which frames can be published.
 #[derive(uniffi::Object)]
 pub struct MoqGroupProducer {
 	sequence: u64,
diff --git a/rs/moq-ffi/src/server.rs b/rs/moq-ffi/src/server.rs
index 47504eb97f3..ffc8b1f21d7 100644
--- a/rs/moq-ffi/src/server.rs
+++ b/rs/moq-ffi/src/server.rs
@@ -1,3 +1,5 @@
+//! Accept incoming MoQ sessions.
+
 use std::path::PathBuf;
 use std::sync::Arc;
 
diff --git a/rs/moq-ffi/src/session.rs b/rs/moq-ffi/src/session.rs
index f2efee71ec7..b0f16a2ee95 100644
--- a/rs/moq-ffi/src/session.rs
+++ b/rs/moq-ffi/src/session.rs
@@ -1,3 +1,5 @@
+//! Connect to peers and manage MoQ sessions.
+
 use std::sync::Arc;
 
 use url::Url;
@@ -877,6 +879,7 @@ impl Accepted {
 	}
 }
 
+/// A connection that exchanges broadcasts with a peer.
 #[derive(uniffi::Object)]
 pub struct MoqSession {
 	inner: Inner,
diff --git a/rs/moq-ffi/src/video.rs b/rs/moq-ffi/src/video.rs
index abaf4ca0b29..c813abc1208 100644
--- a/rs/moq-ffi/src/video.rs
+++ b/rs/moq-ffi/src/video.rs
@@ -70,7 +70,10 @@ pub enum MoqVideoEncoderKind {
 	/// `"openh264"` (software, everywhere).
 	/// Naming one this build lacks fails with a no-encoder error, so reach for
 	/// this only when [`Auto`](Self::Auto) picks the wrong one.
-	Named { name: String },
+	Named {
+		/// The encoder backend name to open.
+		name: String,
+	},
 }
 
 impl From<MoqVideoEncoderKind> for moq_video::encode::Kind {
@@ -89,6 +92,7 @@ impl From<MoqVideoEncoderKind> for moq_video::encode::Kind {
 /// match `width` x `height`; scale before writing if your source moves.
 #[derive(uniffi::Record)]
 pub struct MoqVideoEncoderInput {
+	/// The raw pixel layout.
 	pub format: MoqVideoPixelFormat,
 	/// Encoded width in pixels. Must be even (I420 chroma is subsampled 2x2).
 	pub width: u32,
@@ -102,6 +106,7 @@ pub struct MoqVideoEncoderInput {
 /// Codec-side configuration.
 #[derive(uniffi::Record)]
 pub struct MoqVideoEncoderOutput {
+	/// The codec used to encode this rendition.
 	pub codec: MoqVideoCodec,
 	/// Track name for a broadcast-bound producer. `None` derives one from the codec.
 	#[uniffi(default = None)]
@@ -122,7 +127,10 @@ pub struct MoqVideoEncoderOutput {
 #[derive(Clone, Copy, uniffi::Enum)]
 pub enum MoqVideoGop {
 	/// Start a group with a keyframe every `interval` frames.
-	Keyframe { interval: u32 },
+	Keyframe {
+		/// The number of frames between keyframes.
+		interval: u32,
+	},
 }
 
 impl From<MoqVideoGop> for moq_video::encode::Gop {
@@ -761,7 +769,10 @@ pub struct MoqVideoDecoderOutput {
 #[derive(Clone, Copy, uniffi::Enum)]
 pub enum MoqVideoSurface {
 	/// An Apple `CVPixelBufferRef` from VideoToolbox, IOSurface-backed NV12.
-	PixelBuffer { pointer: u64 },
+	PixelBuffer {
+		/// The borrowed CVPixelBuffer address, valid while the frame is held.
+		pointer: u64,
+	},
 }
 
 /// One decoded video frame, owning the surface it was decoded into.
diff --git a/swift/Sources/Moq/Aliases.swift b/swift/Sources/Moq/Aliases.swift
index 97c8cce74e2..1f993116d70 100644
--- a/swift/Sources/Moq/Aliases.swift
+++ b/swift/Sources/Moq/Aliases.swift
@@ -24,7 +24,7 @@ public typealias VideoDecoderOutput = MoqVideoDecoderOutput
 /// One decoded video frame, owning the decoder's surface until released;
 /// `pixels(format:)` converts it to packed CPU pixels.
 public typealias VideoDecodedFrame = MoqVideoDecodedFrame
-/// The PCM layout an `AudioConsumer` decodes to, plus its max delay.
+/// The decoded PCM layout, maximum group staleness, and playout delay.
 public typealias AudioDecoderOutput = MoqFFI.MoqAudioDecoderOutput
 /// A raw PCM sample format, mirroring WebCodecs `AudioData.format`.
 public typealias AudioSampleFormat = MoqFFI.MoqAudioSampleFormat

From 500035ad673ef01d25d982fad9c604f66dc1908c Mon Sep 17 00:00:00 2001
From: Luke Curley <kixelated@gmail.com>
Date: Tue, 20 Oct 2026 13:22:05 -0700
Subject: [PATCH 3/5] docs(bindings): synchronize generated Dart checksums

Co-Authored-By: GPT-6 <noreply@openai.com>
---
 dart/moq_ffi/lib/src/moq.dart | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/dart/moq_ffi/lib/src/moq.dart b/dart/moq_ffi/lib/src/moq.dart
index 8c807bd0d31..63f43a5b69b 100644
--- a/dart/moq_ffi/lib/src/moq.dart
+++ b/dart/moq_ffi/lib/src/moq.dart
@@ -8,9 +8,7 @@ import "dart:ffi";
 import "dart:io" show Platform, File, Directory;
 import "dart:isolate";
 import "dart:typed_data";
-
 import "package:ffi/ffi.dart";
-
 import "uniffi_runtime.dart";
 export "uniffi_runtime.dart";
 
@@ -18489,7 +18487,7 @@ void _checkApiChecksums() {
   if (uniffi_moq_ffi_checksum_method_moqaudioproducer_demand() != 42822) {
     throw UniffiInternalError.panicked("UniFFI API checksum mismatch");
   }
-  if (uniffi_moq_ffi_checksum_method_moqaudioproducer_finish() != 6287) {
+  if (uniffi_moq_ffi_checksum_method_moqaudioproducer_finish() != 52976) {
     throw UniffiInternalError.panicked("UniFFI API checksum mismatch");
   }
   if (uniffi_moq_ffi_checksum_method_moqaudioproducer_reanchor() != 34412) {
@@ -18498,7 +18496,7 @@ void _checkApiChecksums() {
   if (uniffi_moq_ffi_checksum_method_moqaudioproducer_reservation() != 43848) {
     throw UniffiInternalError.panicked("UniFFI API checksum mismatch");
   }
-  if (uniffi_moq_ffi_checksum_method_moqaudioproducer_write() != 22094) {
+  if (uniffi_moq_ffi_checksum_method_moqaudioproducer_write() != 48796) {
     throw UniffiInternalError.panicked("UniFFI API checksum mismatch");
   }
   if (uniffi_moq_ffi_checksum_method_moqbandwidth_reserve() != 27807) {

From a95d65e72ec1a3734afc3993d45a0a6d4036be3d Mon Sep 17 00:00:00 2001
From: Luke Curley <kixelated@gmail.com>
Date: Tue, 20 Oct 2026 13:27:56 -0700
Subject: [PATCH 4/5] docs(bindings): explain metadata checksum migration

Co-Authored-By: GPT-6 <noreply@openai.com>
---
 cpp/moq/MIGRATE.md      |  7 +++++++
 dart/moq/MIGRATE.md     |  7 +++++++
 dart/moq_ffi/MIGRATE.md | 12 ++++++++++++
 go/ffi/MIGRATE.md       | 11 +++++++++++
 go/wrapper/MIGRATE.md   |  7 +++++++
 kt/moq-ffi/MIGRATE.md   | 11 +++++++++++
 kt/moq/MIGRATE.md       |  7 +++++++
 py/moq-ffi/MIGRATE.md   | 11 +++++++++++
 py/moq-rs/MIGRATE.md    |  6 ++++++
 rs/moq-ffi/MIGRATE.md   |  7 +++++++
 swift/MIGRATE.md        |  7 +++++++
 swift/ffi/MIGRATE.md    | 11 +++++++++++
 12 files changed, 104 insertions(+)
 create mode 100644 dart/moq_ffi/MIGRATE.md
 create mode 100644 go/ffi/MIGRATE.md
 create mode 100644 kt/moq-ffi/MIGRATE.md
 create mode 100644 py/moq-ffi/MIGRATE.md
 create mode 100644 swift/ffi/MIGRATE.md

diff --git a/cpp/moq/MIGRATE.md b/cpp/moq/MIGRATE.md
index 89169b3ff78..6cabfe38e38 100644
--- a/cpp/moq/MIGRATE.md
+++ b/cpp/moq/MIGRATE.md
@@ -4,6 +4,13 @@ How to update your code for each breaking change, newest first.
 
 ## Unreleased
 
+### Rebuild the matching raw bindings
+
+The documentation update changes UniFFI's audio-producer method metadata checksums.
+Regenerate the C++ binding headers and sources from the rebuilt native library,
+then rebuild the application; older generated guards reject the rebuilt library.
+Application calls are unchanged.
+
 ### JSON consumers return `JsonValue` (#5677)
 
 `JsonSnapshotConsumer::next()` and `JsonStreamConsumer::next()` return `JsonValue` (`value`, `timestamp_us`) instead of a string; `timestamp_us` is empty when untimed.
diff --git a/dart/moq/MIGRATE.md b/dart/moq/MIGRATE.md
index 8154fd68df2..025371080f9 100644
--- a/dart/moq/MIGRATE.md
+++ b/dart/moq/MIGRATE.md
@@ -4,6 +4,13 @@ How to update your code for each breaking change, newest first.
 
 ## Unreleased
 
+### Rebuild the matching raw bindings
+
+The documentation update changes UniFFI's audio-producer method metadata checksums.
+Update `moq_ffi` and its native library together; older generated guards reject the rebuilt library.
+For a custom native library, regenerate its matching Dart bindings with `just dart generate`.
+Application calls are unchanged.
+
 ### JSON consumers return `Value` (#5677)
 
 `SnapshotConsumer.next()` and `StreamConsumer.next()` return `Value` (`value`, `timestampUs`) instead of a string; `timestampUs` is null when untimed.
diff --git a/dart/moq_ffi/MIGRATE.md b/dart/moq_ffi/MIGRATE.md
new file mode 100644
index 00000000000..fcfb6c6b00a
--- /dev/null
+++ b/dart/moq_ffi/MIGRATE.md
@@ -0,0 +1,12 @@
+# Migrating the Dart moq\_ffi package
+
+How to update your code for each breaking change, newest first.
+
+## Unreleased
+
+### Regenerate the matching bindings
+
+Documentation on `MoqAudioProducer::write` and `finish` changes their UniFFI metadata checksums.
+Keep the generated Dart code and native library together.
+For a custom native build, regenerate the matching bindings with `just dart generate`.
+The method signatures and behavior are unchanged.
diff --git a/go/ffi/MIGRATE.md b/go/ffi/MIGRATE.md
new file mode 100644
index 00000000000..943e86f1f17
--- /dev/null
+++ b/go/ffi/MIGRATE.md
@@ -0,0 +1,11 @@
+# Migrating the Go moq-ffi module
+
+How to update your code for each breaking change, newest first.
+
+## Unreleased
+
+### Regenerate the matching bindings
+
+Documentation on `MoqAudioProducer::write` and `finish` changes their UniFFI metadata checksums.
+Regenerate the Go sources and bundle the matching static libraries, then rebuild callers.
+The method signatures and behavior are unchanged.
diff --git a/go/wrapper/MIGRATE.md b/go/wrapper/MIGRATE.md
index bd15cc49975..020f7730fc7 100644
--- a/go/wrapper/MIGRATE.md
+++ b/go/wrapper/MIGRATE.md
@@ -4,6 +4,13 @@ How to update your code for each breaking change, newest first.
 
 ## Unreleased
 
+### Rebuild the matching raw bindings
+
+The documentation update changes UniFFI's audio-producer method metadata checksums.
+Update generated `moq.dev/moq-ffi` sources and its bundled static libraries together,
+then rebuild the application; older generated guards reject the rebuilt library.
+Application calls are unchanged.
+
 ### JSON consumers return `*json.Timed` (#5677)
 
 `SnapshotConsumer.Next`, `StreamConsumer.Next`, and `All` return `*Timed{Value, Timestamp}` instead of the raw message; `Timestamp` is a `*time.Duration`, nil when untimed.
diff --git a/kt/moq-ffi/MIGRATE.md b/kt/moq-ffi/MIGRATE.md
new file mode 100644
index 00000000000..2eecf897139
--- /dev/null
+++ b/kt/moq-ffi/MIGRATE.md
@@ -0,0 +1,11 @@
+# Migrating the Kotlin moq-ffi package
+
+How to update your code for each breaking change, newest first.
+
+## Unreleased
+
+### Regenerate the matching bindings
+
+Documentation on `MoqAudioProducer::write` and `finish` changes their UniFFI metadata checksums.
+Regenerate the Kotlin sources and package matching native libraries, then rebuild callers.
+The method signatures and behavior are unchanged.
diff --git a/kt/moq/MIGRATE.md b/kt/moq/MIGRATE.md
index 51b55968ef0..4cba30da73a 100644
--- a/kt/moq/MIGRATE.md
+++ b/kt/moq/MIGRATE.md
@@ -4,6 +4,13 @@ How to update your code for each breaking change, newest first.
 
 ## Unreleased
 
+### Rebuild the matching raw bindings
+
+The documentation update changes UniFFI's audio-producer method metadata checksums.
+Regenerate the Kotlin sources and update the native libraries in `moq-ffi` together,
+then rebuild the application; older generated guards reject the rebuilt library.
+Application calls are unchanged.
+
 ### JSON consumers emit timestamps (#5677)
 
 `values()` emits `json.Value` (`value`, plus `timestamp` as a `Duration?`) instead of a string, and `valuesAs<T>()` emits `Timed<T>(value, timestamp)`.
diff --git a/py/moq-ffi/MIGRATE.md b/py/moq-ffi/MIGRATE.md
new file mode 100644
index 00000000000..e88a41ac96f
--- /dev/null
+++ b/py/moq-ffi/MIGRATE.md
@@ -0,0 +1,11 @@
+# Migrating the Python moq-ffi package
+
+How to update your code for each breaking change, newest first.
+
+## Unreleased
+
+### Regenerate the matching bindings
+
+Documentation on `MoqAudioProducer::write` and `finish` changes their UniFFI metadata checksums.
+Rebuild or reinstall the complete wheel so its generated Python code and native library match.
+The method signatures and behavior are unchanged.
diff --git a/py/moq-rs/MIGRATE.md b/py/moq-rs/MIGRATE.md
index 8dac627d188..66c1b728f89 100644
--- a/py/moq-rs/MIGRATE.md
+++ b/py/moq-rs/MIGRATE.md
@@ -4,6 +4,12 @@ How to update your code for each breaking change, newest first.
 
 ## Unreleased
 
+### Rebuild the matching raw bindings
+
+The documentation update changes UniFFI's audio-producer method metadata checksums.
+Rebuild or reinstall the complete `moq-ffi` wheel, keeping its generated Python code
+and native library together; application calls are unchanged.
+
 ### JSON consumers yield `json.Timed` (#5677)
 
 `json.SnapshotConsumer` and `json.StreamConsumer` yield `Timed(value, timestamp)` instead of the bare value; `timestamp` is a `timedelta`, or `None` when untimed.
diff --git a/rs/moq-ffi/MIGRATE.md b/rs/moq-ffi/MIGRATE.md
index 7c30fe86411..086ffd62b4a 100644
--- a/rs/moq-ffi/MIGRATE.md
+++ b/rs/moq-ffi/MIGRATE.md
@@ -5,6 +5,13 @@ These are the UniFFI names; each language wrapper has its own `MIGRATE.md` in it
 
 ## Unreleased
 
+### Regenerate bindings after the API documentation update
+
+The new documentation on `MoqAudioProducer::write` and `finish` changes their
+UniFFI metadata checksums, even though their signatures and behavior are unchanged.
+Regenerate each language's bindings from the rebuilt library and update them together.
+Older generated bindings with active checksum guards reject this library during initialization.
+
 ### JSON consumers return `MoqJsonValue` (#5677)
 
 `MoqJsonSnapshotConsumer::next` and `MoqJsonStreamConsumer::next` return `MoqJsonValue { value, timestamp_us }` instead of a string; `timestamp_us` is null when untimed.
diff --git a/swift/MIGRATE.md b/swift/MIGRATE.md
index 1e51e61d5e4..97c0a8eb764 100644
--- a/swift/MIGRATE.md
+++ b/swift/MIGRATE.md
@@ -4,6 +4,13 @@ How to update your code for each breaking change, newest first.
 
 ## Unreleased
 
+### Rebuild the matching raw bindings
+
+The documentation update changes UniFFI's audio-producer method metadata checksums.
+Regenerate the Swift sources and rebuild the `MoqFFI` XCFramework together,
+then rebuild the application; older generated guards reject the rebuilt library.
+Application calls are unchanged.
+
 ### JSON consumers yield `Json.Timed` (#5677)
 
 `Json.SnapshotConsumer` and `Json.StreamConsumer` yield `Json.Timed<Value>` (`value`, `timestampUs`) instead of the bare value; `timestampUs` is `nil` when untimed.
diff --git a/swift/ffi/MIGRATE.md b/swift/ffi/MIGRATE.md
new file mode 100644
index 00000000000..d85c40bac2d
--- /dev/null
+++ b/swift/ffi/MIGRATE.md
@@ -0,0 +1,11 @@
+# Migrating the Swift MoqFFI package
+
+How to update your code for each breaking change, newest first.
+
+## Unreleased
+
+### Regenerate the matching bindings
+
+Documentation on `MoqAudioProducer::write` and `finish` changes their UniFFI metadata checksums.
+Regenerate the Swift sources and rebuild the matching XCFramework, then rebuild callers.
+The method signatures and behavior are unchanged.

From 98d7f53f7ba2daace353dec659d324843a8350ba Mon Sep 17 00:00:00 2001
From: Luke Curley <kixelated@gmail.com>
Date: Tue, 20 Oct 2026 22:06:29 -0700
Subject: [PATCH 5/5] docs(ffi): state the standalone audio encoder's 48 kHz
 stereo defaults

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 rs/moq-ffi/src/audio.rs | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/rs/moq-ffi/src/audio.rs b/rs/moq-ffi/src/audio.rs
index d8c21270775..ae9a0dc896f 100644
--- a/rs/moq-ffi/src/audio.rs
+++ b/rs/moq-ffi/src/audio.rs
@@ -124,9 +124,8 @@ pub struct MoqAudioEncoderInput {
 	pub channels: u32,
 }
 
-/// Codec-side configuration. `sample_rate` / `channels` `None` means
-/// "match the input (snapping the rate up to a libopus-supported
-/// value if necessary)".
+/// Codec-side configuration for a [`MoqAudioProducer`] or a standalone [`MoqAudioEncoder`].
+/// Opus snaps the encoded rate up to one libopus supports.
 #[derive(uniffi::Record)]
 pub struct MoqAudioEncoderOutput {
 	/// The codec used to encode this rendition.
@@ -134,10 +133,12 @@ pub struct MoqAudioEncoderOutput {
 	/// Track name for a broadcast-bound producer. `None` derives one from the codec.
 	#[uniffi(default = None)]
 	pub track: Option<String>,
-	/// The encoded samples per second, or absent to match the input rate.
+	/// The encoded samples per second. Absent matches a producer's input rate,
+	/// or 48000 for a standalone encoder, which has no input to match.
 	#[uniffi(default = None)]
 	pub sample_rate: Option<u32>,
-	/// The encoded channel count, or absent to match the input.
+	/// The encoded channel count. Absent matches a producer's input, or 2 for a
+	/// standalone encoder, which has no input to match.
 	#[uniffi(default = None)]
 	pub channels: Option<u32>,
 	/// The target bitrate in bits per second, or absent for the codec default.