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 @@

What if the switcher
was shared memory?

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.

See it in action + Evaluate MXL with us Explore the source Run it in ~10 minutes
@@ -326,9 +328,9 @@

From fresh Ubuntu VM to a cuttable MXL production in about ten minutes.

AN OPEN QUESTION, RUNNING AS CODE

-

What should an MXL-native
switcher become?

-

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.

- +

What should MXL prove
for your team?

+

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.

+
diff --git a/docs/pilot.html b/docs/pilot.html new file mode 100644 index 0000000..414a3a8 --- /dev/null +++ b/docs/pilot.html @@ -0,0 +1,204 @@ + + + + + + + + + + + + + + MXL Production Pilot — Switcher Lab for MXL + + + + + + +
+ + Fixed-scope engineering pilot · evidence before expansion +
+ + + +
+
+
+

MXL PRODUCTION PILOT / BOUNDED · MEASURED · REPEATABLE

+

Turn an MXL question into a working production proof.

+

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.

+
+
+ Browser-based MXL production switcher with program, preview and source tiles +
REFERENCE SURFACE / Program, preview, source selection and live-status feedback over a software-defined MXL core.
+
+
+ +
+
+
8native MXL contribution sources demonstrated in one production canvas
+
2160p30CPU-first Program delivered to YouTube over RTMPS
+
43.9–53.4%lower measured reader CPU than the compared NDI path in a bounded same-host test
+
<80 MiBfor the Core cut/take path in the measured reference configuration
+
+
+ +
+
+

01 / THE OUTCOME

A decision package, not an endless prototype.

+

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.

+
+
+
01

Success contract

One workflow, named inputs and outputs, observable pass/fail criteria, resource limits and an agreed stop condition.

+
02

Working vertical slice

A real signal path using the minimum useful set of contribution, MXL processing, operator control and delivery functions.

+
03

Operator surface

A role-appropriate control or health view so the proof looks and behaves like broadcast equipment—not a collection of terminal windows.

+
04

Evidence package

Measured cadence, drops, CPU, memory and recovery behavior, plus screenshots, reproducible steps and known limitations.

+
05

Go / adapt / stop recommendation

A concise architecture recommendation showing what belongs in MXL, what stays at the edge and what should not be built yet.

+
06

Handoff

Public-safe documentation and a private operator handoff that another engineer can follow without depending on the original lab.

+
+
+ +
+
+
+

02 / STARTING PROFILE

Compress at the edge.
Share in the core.

+

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.

+
+
+
CONTRIBUTION

ZoomISO · SRT · NDI

Keep transport-specific behavior at an adapter boundary. Prove only the sources the pilot actually needs.

+ +
PRODUCTION

MXL core + skin

Discoverable flows, cuts, layouts, audio, multiview and health on a measured CPU/RAM envelope.

+ +
DELIVERY

YouTube · SRT · confidence

Encode once at the boundary and monitor the destination independently from the production core.

+
+
+
+ +
+
+

03 / FIT CHECK

+

Useful now—and explicit about what is not ready.

+
+
+
+

Good pilot fit

+
    +
  • Build a credible MXL production demo for customers or internal stakeholders.
  • +
  • Integrate one vendor function or transport into an MXL workflow.
  • +
  • Compare a bounded MXL path with an existing NDI or SRT approach.
  • +
  • Measure a deployment before funding a larger product effort.
  • +
+
+
+

Not the current promise

+
    +
  • A feature-for-feature replacement for vMix, OBS, AMPP or a production switcher.
  • +
  • An unattended 24/7 appliance with a full broadcast SLA.
  • +
  • A universal claim that MXL always outperforms every NDI configuration.
  • +
  • A finished TAMS editing, trimming and replay product.
  • +
+
+
+
+ +
+
+
+

04 / WHY THIS LAB

The failures are part of the deliverable.

+

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.

+
+
+
BOUND THE CLAIM

Measure the exact path

CPU and reliability statements are tied to disclosed formats, readers, host classes and test conditions.

+
REHEARSE THE INSTALL

Fresh-host workflows

Deployment is treated as part of the product. A result that only works on the original lab is not accepted.

+
OPERATE, DON'T JUST RENDER

Health and recovery

The proof includes visible state, safe controls and recovery behavior—not only a successful frame grab.

+
KEEP THE GATE

No automatic expansion

The next feature or topology is funded only after the current pilot earns a reason to continue.

+
+
+
+ +
+
+

START WITH THE DECISION

+

What would MXL have to prove for your team?

+

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.

+
+
+
+ + + + diff --git a/docs/sitemap.xml b/docs/sitemap.xml index 96c1259..e474247 100644 --- a/docs/sitemap.xml +++ b/docs/sitemap.xml @@ -90,6 +90,12 @@ monthly 0.7 + + https://mxlswitcher.com/pilot.html + 2026-10-17 + monthly + 0.9 + https://mxlswitcher.com/changelog.html 2026-09-30