Skip to content

docs: Brighter 10.8.1 — pins, tools, tutorials and what the release made false - #206

Merged
iancooper merged 2 commits into
masterfrom
bugfix/brighter-10.8.1
Oct 24, 2026
Merged

iancooper merged 2 commits into
masterfrom
bugfix/brighter-10.8.1

Conversation

@iancooper

Copy link
Copy Markdown
Member

Brighter 10.8.1 shipped; the docs were written against 10.8.0. This is RELEASE_CHECKLIST.md steps 1–6, plus the two blockcheck pins and symbolcheck's release tag, scoped (as for 10.8.0) to the checklist and every claim the release made false. The full record, with every finding's evidence: bugfixes/0003-brighter-10.8.1/bugfix.md.

What changed

  • Pins and tools: the 18 tutorial pins; optioncheck, refs and refs-v4 → 10.8.1 (Confluent Avro serdes → 2.16.0, with Kafka 10.8.1); symbolcheck's tag.
  • optioncheck: 7 findings → 0 (59 tables, 533 rows): ASB ForwardTo, the ASB scheduler's InstrumentationOptions, Publication.RequeueScheduler, outstandingCountTimeout, InboxConfiguration now nullable, Hangfire's lazy Client.
  • The global Inbox is opt-in. AddConsumers registers no Inbox unless InboxConfiguration is set — and a handler marked [UseInbox] without one now fails every send (run: ConfigurationException, or NullReferenceException through the Func overload). Inbox, Dispatcher, transactional-messaging and MSSQL transport pages.
  • The Dispatcher health check is obsolete (CS0618). HealthChecks.md now registers the remedy checks (AddBrighterConsumerHealthChecks), with the old form under ❌/✅; the old check's Degraded-on-channel-failures row.
  • Sweeper telemetry: two new gauges; a hung sweep is visible; the stall alert uses running_time; the section's version floor.
  • MongoDB: the transaction provider passes directly (fix!, #4617). ASB: a requeue delay needs a queue. BoxProvisioning: SchemaName/SourceReference reject empty values. Sweeper: TimerInterval's check is 10.8.1's.

Verified

  • Behavioural claims run, with 10.8.0 as the control — five probes under bugfixes/0003-brighter-10.8.1/probe/ (Inbox ×2, Hangfire, outstandingCountTimeout, MongoDB on a replica set, consumer health checks, sweeper gauges). One claim read from source (the ASB warning; needs a namespace).
  • Tutorials replayed on a clean machine: all four rungs pass on 10.8.1, no page repair; run table updated.
  • Gates: blockcheck --report 994 / 644 / 323 / 27, 0 findings (the report against 10.8.1 was byte-identical to 10.8.0's before the page changes; HealthChecks.md Update ImplementingAHandler.rst #2, Passing information to the caller #3 baselined); pagelint 0 errors / 271; --plant 5/5; linkcheck 169 / 0; symbolcheck 0 (24 entries, still dead at 10.8.1); versioncheck 0 of 18; optioncheck 0 / 59 / 533; urlmap --verify 161 = 161.

Follow-ups, not in this change

Listed in the record: two possible upstream issues (the Func overload's null Inbox factory; channelFailureDelay apparently unapplied) and one release-note inaccuracy, for the maintainer to file or not; replay notes on rung 4; MongoDBOutbox.md's collection pre-creation; dated notes 10.8.1 may have fixed; new features with no page.

Asked of the maintainer

  1. Sign-off to merge — this changes the published site.
  2. Permission to delete the head ref bugfix/brighter-10.8.1 after it merges.

Spec 018 phase 6 (spec/018-phase6, local) resumes after this merges, re-deriving its figures against 10.8.1.

🤖 Generated with Claude Code

https://claude.ai/code/session_01LjnH2pJ98aMabu1MyTpRxy

iancooper and others added 2 commits October 23, 2026 00:57
…ade false

RELEASE_CHECKLIST.md steps 1-6 on Brighter 10.8.1, plus the two blockcheck
pins and symbolcheck's release tag, scoped by the maintainer to the checklist
and every claim the release made false. Record:
bugfixes/0003-brighter-10.8.1/bugfix.md.

- the 18 tutorial pins versioncheck named; optioncheck, refs and refs-v4 to
  10.8.1, Confluent Avro serdes 2.16.0 with Kafka 10.8.1; symbolcheck's tag
- optioncheck's 7 findings repaired: ASB ForwardTo, the scheduler's
  InstrumentationOptions, Publication.RequeueScheduler, outstandingCountTimeout,
  the nullable InboxConfiguration and the lazy Hangfire client
- the global Inbox is opt-in: [UseInbox] without InboxConfiguration now fails
  every send; Inbox, Dispatcher, transactional and MSSQL transport pages
- the Dispatcher health check is obsolete; HealthChecks.md registers the
  remedy checks; the sweeper's two gauges and a stall alert that sees a hang
- MongoDB's provider passes directly; ASB requeue delay needs a queue;
  SchemaName/SourceReference reject empty; TimerInterval's check is 10.8.1's
- behavioural claims run with 10.8.0 as the control (five probes)
- tutorials replayed on a clean machine: all four pass, no page repair

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LjnH2pJ98aMabu1MyTpRxy
…DME rows 1, 6 and 9

- the obsolete Dispatcher check and its replacement both build at 35b0bc2:
  --report 994 / 644 / 323 / 27, 0 findings, exit 0
- README: linkcheck 169 files, optioncheck 533 rows at 10.8.1, blockcheck's
  figures at bugfix 0003

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LjnH2pJ98aMabu1MyTpRxy
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant