Success contract
One workflow, named inputs and outputs, observable pass/fail criteria, resource limits and an agreed stop condition.
From 454a5517a03fce87e25a8c9bda56da3f12dddb0f Mon Sep 17 00:00:00 2001 From: Guy Cochran <81593178+guycochran@users.noreply.github.com> Date: Sat, 17 Oct 2026 11:42:32 -0700 Subject: [PATCH] docs: add bounded MXL production pilot offer Signed-off-by: Guy Cochran <81593178+guycochran@users.noreply.github.com> --- docs/REVIEW-RESPONSE.md | 58 ++++++++++++ docs/index.html | 8 +- docs/pilot.html | 204 ++++++++++++++++++++++++++++++++++++++++ docs/sitemap.xml | 6 ++ 4 files changed, 273 insertions(+), 3 deletions(-) create mode 100644 docs/REVIEW-RESPONSE.md create mode 100644 docs/pilot.html diff --git a/docs/REVIEW-RESPONSE.md b/docs/REVIEW-RESPONSE.md new file mode 100644 index 0000000..ea7aa7b --- /dev/null +++ b/docs/REVIEW-RESPONSE.md @@ -0,0 +1,58 @@ +# Review response thread + +Shared async thread between the author and the independent reviewer. Each item carries a +status: `open` / `fixed` / `disputed` / `wontfix` / `needs-decision` / +`needs-hw-verify`. + +## Oct 9 — Guy's decisions + actions on the Oct 9 review + +Thanks for the thorough pass. Guy made the five calls; here they are, with what's done. + +### Decisions from Guy + +1. **Merge order** — `fixed(plan)`: proceed in the recommended order **#38 → #40 → #37 → #39 → #41**. + #37 is held until its open notes below are addressed; the other four can go once conflicts + are resolved. +2. **Deploying unmerged branches to the live box** — `accepted`: continue only to close the + verification gap faster, with the merge plan above ending the drift. Box-specific details + stay uncommitted or placeholdered, never on master. +3. **/join policy** — `decided`: **passphrase (merge #40)**. Public contributors must present + the SRT passphrase; the /join QR embeds it so legitimate scanners stay one-tap. +4. **Apache copyright holder (#39)** — `decided`: **Guy Cochran** (individual). +5. **Naming the hostname + Jonas** — `decided`: remove the live hostname from the repo; drop + the employer tag on the EFA changelog line; retain the public open-source proxy credit. + +### Actions already taken (Oct 9) + +- **Hostname leak (#41)** — `fixed`: committed documentation no longer hardcodes the live + server hostname. +- **Control API hardening** — `fixed`: mediamtx's API binds to localhost rather than all + interfaces. +- **Employer tag (#37 changelog)** — `fixed`: the entry states the technical cause without + identifying an individual or employer. + +### Still open — #37 notes + +- `open`: NMOS routing still ignores the flow ID; the domain ID is not a proper UUID; the ADR + over-claims both as done; the soak check reports a stale result as a failure; the PR is too + broad. Address these before merge. + +## Oct 9 (later) — two more decisions from Guy + +- **Multiview visibility (#40)** — `decided`: passphrase-to-publish is enough; public viewing + is acceptable for the demo. +- **Core-vs-Skin leak sweep** — `fixed` in PR #42: runnable Core defaults are neutral while + the project publication may retain its authorship and field notes. + +## Oct 17 — commercialization validation page + +- **Pilot offer page** — `open`: `docs/pilot.html` adds a bounded, measured pilot offer and + explicitly excludes a general-purpose production-platform promise, a 24/7 SLA, universal + MXL-vs-NDI claims, and finished TAMS editing/replay. +- **Claim discipline** — `fixed`: the page carries only already documented proof points and + labels the CPU comparison as a bounded same-host test. +- **Runtime impact** — `fixed`: documentation-only; no Core, live-system, tunnel, cloud, Docker, + meeting, mapping or service changes. +- **Review request** — `open`: verify that the public wording does not overstate the evidence + and that the pilot scope remains commercially useful without implying product maturity. + diff --git a/docs/index.html b/docs/index.html index 975a3ce..2b8d7e2 100644 --- a/docs/index.html +++ b/docs/index.html @@ -74,6 +74,7 @@ Architecture What is MXL Findings + Pilot Learn MXL The field @@ -88,6 +89,7 @@
A working exploration of a live production control room built around the Media eXchange Layer: real cameras, remote guests, playout, layouts, graphics, audio, multiview, recording and standard control — assembled as software on general-purpose cloud VMs.
@@ -326,9 +328,9 @@AN OPEN QUESTION, RUNNING AS CODE
-Fork it. Reproduce it. Challenge the measurements. Replace a function. Bring a different controller. File what breaks. The point is not to define the answer alone — it is to make the conversation testable.
- +Run the open reference stack, challenge the measurements, or define a bounded production pilot around one real workflow. The next step is not more features—it is a decision supported by working evidence.
+MXL PRODUCTION PILOT / BOUNDED · MEASURED · REPEATABLE
+A focused engineering engagement for broadcasters, vendors and integrators. We take one real workflow from contribution to control and delivery, measure it, document it and finish with a clear recommendation: go, adapt or stop.
+ +This is not a promise to replace an entire production platform. It is a disciplined way to decide where MXL creates practical value in your system.
+
+ 01 / THE OUTCOME
Every pilot starts with the decision your team needs to make and ends with enough evidence to make it. The working demo matters; the repeatable evidence and honest boundary matter more.
+One workflow, named inputs and outputs, observable pass/fail criteria, resource limits and an agreed stop condition.
A real signal path using the minimum useful set of contribution, MXL processing, operator control and delivery functions.
A role-appropriate control or health view so the proof looks and behaves like broadcast equipment—not a collection of terminal windows.
Measured cadence, drops, CPU, memory and recovery behavior, plus screenshots, reproducible steps and known limitations.
A concise architecture recommendation showing what belongs in MXL, what stays at the edge and what should not be built yet.
Public-safe documentation and a private operator handoff that another engineer can follow without depending on the original lab.
02 / STARTING PROFILE
The recommended first deployment is a single production host with enough CPU and RAM for the validated workload. SRT, NDI, SDI or ZoomISO can terminate at adapters; MXL carries timestamped media between in-host functions; a purpose-built edge encodes the finished output.
+Keep transport-specific behavior at an adapter boundary. Prove only the sources the pilot actually needs.
Discoverable flows, cuts, layouts, audio, multiview and health on a measured CPU/RAM envelope.
Encode once at the boundary and monitor the destination independently from the production core.
03 / FIT CHECK
+04 / WHY THIS LAB
The reference work has already exposed cadence errors, stale flows, audio-boundary problems, cloud sizing limits and operator-recovery gaps. The pilot converts that experience into acceptance gates instead of rediscovering it on your budget.
+CPU and reliability statements are tied to disclosed formats, readers, host classes and test conditions.
Deployment is treated as part of the product. A result that only works on the original lab is not accepted.
The proof includes visible state, safe controls and recovery behavior—not only a successful frame grab.
The next feature or topology is funded only after the current pilot earns a reason to continue.
START WITH THE DECISION
+Bring one workflow and one decision. We will define the smallest credible proof, the evidence it must produce and the condition that keeps the project from becoming open-ended.
+ +Scope, schedule, fee, required licenses and cloud costs are agreed before work begins. MXL is presented as complementary to NDI, SRT, ST 2110 and IPMX—not as a universal replacement for them.
+