Skip to content

docs(dnn): refresh 2 go-live docs post-execution + fix B1-inversion in turnkey - #794

Merged
jsboige merged 1 commit into
masterfrom
docs/dnn-golive-turnkey-postexec
Jul 12, 2026
Merged

docs(dnn): refresh 2 go-live docs post-execution + fix B1-inversion in turnkey#794
jsboige merged 1 commit into
masterfrom
docs/dnn-golive-turnkey-postexec

Conversation

@jsboige

@jsboige jsboige commented Jul 12, 2026

Copy link
Copy Markdown
Contributor

Context

Continuation of the DNN runbook refresh (companion to PR #792, same dispatch 2lnzsb secondary "scope/refresh les runbooks"). The 2 operational go-live docs in docs/dnn/ were written 2026-06-26 as PRE-execution navigators. Since then the sandbox + full-IIS migration was delivered. One carries a dangerous error that would bite a future executor.

What landed (docs-only, 2 files, +45/-2)

go-live-turnkey-checklist.md — POST-EXEC banner + ⛔ CRITICAL B1 correction

  • B1-B3 DELIVERED, only prod VPS go-live (B4) remains. DNN 10.3.2 + 2sxc 21.07 live in full-IIS at dnn.argumentum.myia.io (HTTP 200/~85 KB, 0× "Something went wrong", HTTPS SAN exp 2026-09-27, ACME bypass active).
  • The dangerous part — B1 step 2-3 instructs the WRONG action. As written, it says "fetch the 5 .NET-9 contaminants at 6.0.x" + "align binding redirects → 6.0.0.0." This is the INVERTED thesis, proven WRONG during execution:

    Reverting BCL/SDK DLLs to 6.0.0.0 breaks 2sxc 21. 2sxc 21.07 is compiled against System.Text.Json 9.0.0.0 / System.Composition-SCI 9.0.0.0 / Bcl 8.0.0.0. Reverting → JsonOptions type-init MissingMethodException → every 2sxc module "Something went really wrong in view.ascx".

  • Correct B1 action documented (what actually worked): deploy matched BCL stack from the 2sxc 21.07 Install package + align <assemblyBinding> redirects. Canonical working bin = tmp/dnn-backups/bin_post_2sxc_realign (330 files). Pointer to MEMORY reference-dnn-2sxc-net48-bcl-stack + 682-field-model-revision-2sxc21.md.
  • Release de-coupling noted: B4 (prod VPS go-live) = jsboige ops task, not blocking the v0.9.0 print tag.

go-live-smoke-test.md — POST-EXEC context banner

Checklist remains valid/actionable for the remaining gated step (prod VPS go-live). Sandbox smoke already green (sections A/B proven on the live site); A2/A3/A5 red-flags retained as regression-watch signals, not open blockers. Section B templates source-migrated #596.

Why this is real work (not fabrication)

These are operational docs a future jsboige/VPS-executor would run from. The B1 step as written would, on execution, break 2sxc 21 — a concrete, documented failure mode (the B1 incident already happened). Leaving it un-corrected is the actual bug. This PR supersedes the wrong instruction and marks B1-B3 as historical record.

The same B1-inversion lesson is corrected in 132-deployment-runbook.md §5.5(a) — that's companion PR #792 (3 runbooks). This PR closes the second doc that encoded the error.

Verification

  • Link target docs/dnn-localization/682-field-model-revision-2sxc21.md exists (ls confirmed).
  • Secret-scan: clean (0 hits, no sk-, no API key patterns).
  • Banners cross-reference live state from MEMORY §DNN (verified 2026-07-12).
  • diff scope: +45/-2 docs-only, no .cs, no Cards/, no DB.

Gate

  • ✅ Docs-only (no code, no CSV, no DB, no live mutation)
  • ✅ po-2023 lane (docs/dnn/ operational go-live docs)
  • ✅ No secret in diff
  • ⏸ Gated ai-01 review before merge (worker never self-merges)

Relates: dispatch 2lnzsb secondary, #131/#132 (DNN), PR #792 (companion runbook refresh), MEMORY reference-dnn-2sxc-net48-bcl-stack (B1-inversion).

Co-Authored-By: Claude-Code noreply@anthropic.com

@jsboige @claude
docs(dnn): refresh 2 go-live docs post-execution + fix B1-inversion i…
02a7128 
…n turnkey

The 2 operational go-live docs (go-live-turnkey-checklist.md, go-live-smoke-
test.md) were written 2026-06-26 as PRE-execution navigators. Since then the
sandbox + full-IIS migration was delivered (10.3.2 + 2sxc 21.07 live at
dnn.argumentum.myia.io). One carries a dangerous error that would bite a
future executor.

Changes (docs-only, 2 files, +45/-2):
- go-live-turnkey-checklist.md: POST-EXEC banner (B1-B3 DELIVERED, only prod
  VPS go-live B4 remains) + CRITICAL CORRECTION to B1: the step-2/3
  instruction "fetch .NET-9 contaminants at 6.0.x + align binding redirects
  -> 6.0.0.0" is the INVERTED thesis, proven WRONG during execution.
  Reverting BCL to 6.0.0.0 breaks 2sxc 21 (JsonOptions type-init
  MissingMethodException -> "Something went really wrong"). Correct action =
  deploy matched BCL stack from 2sxc 21.07 Install pkg (Json 9.0.0.0 /
  SCI 9.0.0.0 / Bcl 8.0.0.0) + align redirects. Cross-ref to 132 §5.5a +
  MEMORY reference-dnn-2sxc-net48-bcl-stack. Release de-coupling noted
  (B4 = jsboige ops VPS task, not blocking v0.9.0 print tag).
- go-live-smoke-test.md: POST-EXEC context banner (sandbox smoke already
  green, checklist now prod-replay; A2/A3/A5 red-flags resolved as
  regression-watch not open blockers; release de-coupled).

Same B1-inversion lesson already corrected in 132-deployment §5.5a (companion
PR #792). This PR closes the second doc that encoded the error.

po-2023 lane (docs/dnn/, operational go-live docs). Non-gated. No Cards/,
no .cs, no DB. Gated ai-01 review before merge.

Co-Authored-By: Claude-Code <noreply@anthropic.com>
@jsboige
jsboige merged commit 84a529b into master Jul 12, 2026
3 checks passed
@jsboige
jsboige deleted the docs/dnn-golive-turnkey-postexec branch July 12, 2026 15:00
@jsboige jsboige mentioned this pull request Jul 12, 2026
Merged
5 tasks
jsboige added a commit that referenced this pull request Jul 13, 2026
@jsboige @claude
docs(dnn): #131 index README refresh — B1 sweep 3-doc + i18n portage …
b75df83 
…backlog (#798)

The navigation index (entry point of the #131/#132/#457 arc) was last
refreshed 2026-07-10 (#765). Since then 3 merges changed what it should
report, leaving it stale:

1. B1-inversion correction swept to a 3rd doc — #792 added the lesson to
   132-deployment-runbook.md §5.5(a) as a MANDATORY sub-step (the 07-10
   refresh only named sandbox-bootstrap + go-live-turnkey). #794 extended
   the turnkey fix. §0.5 "stale-doc flags" now lists all 3 docs with PR refs.

2. #682 Path A provisioning manifest (49 fields) merged in #777 — the 3
   #682 docs (decision-input, revision-2sxc21, path-a-provisioning-manifest)
   were missing from §2 supporting-docs table. Added.

3. §4 "jsboige gates pending" listed only #445/#525/visual-verdict — the
   entire i18n portage chain (#682 provisioning → #683 enablement → #684
   re-import) was absent from the backlog. Added as gates 3/4/5, with #684
   prep marked DONE (PR #767) and re-import marked GATED.

Navigation index only — no runbook content rewritten. MD032 on the new
blockquote list resolved with blank > lines (my addition, not surrounding
style). Lane: docs/dnn-localization (po-2023). 0 prod write, 0 CSV.

Co-authored-by: Claude-Code <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@jsboige