Skip to content

docs: prepare v0.12.0 release notes, changelog, and docs version#708

Merged
wbarnha merged 8 commits into
masterfrom
claude/release-v0.12.0-prep
Jul 19, 2026
Merged

docs: prepare v0.12.0 release notes, changelog, and docs version#708
wbarnha merged 8 commits into
masterfrom
claude/release-v0.12.0-prep

Conversation

@wbarnha

@wbarnha wbarnha commented Jul 19, 2026

Copy link
Copy Markdown
Member

Description

Release-prep documentation for v0.12.0. No product code changes —
versioning is setuptools_scm-driven, so the git tag is the version; this PR
prepares the human-facing notes and makes the docs report the right version.

Scope: merged-only. The changelog/release notes describe only what is
already on master. Not-yet-merged work — the offset-commit data-loss fixes
(#606/#707, #316/#692), the optional OpenTracing/OpenTelemetry extras
(#685/#686, #688), web_application_options (#704), and the reported-issue fix
stack (#693#703, #705) — has been removed and will be folded in as it merges.

  • CHANGELOG.md — resumes the Keep a Changelog format (dormant since
    v0.8.10) with a ## [v0.12.0] section (Added / Changed / Fixed /
    Dependencies) and a v0.11.3...v0.12.0 compare link. Date left as
    UNRELEASED; set it at tag time.
  • RELEASE_NOTES_v0.12.0.md — standalone GitHub release notes with
    highlights and a Breaking changes / upgrade notes section.
  • docs/conf.py — Sphinx docs version now derived from faust.__version__
    (setuptools_scm / git tag) instead of the hardcoded robinhood-era
    1.1/1.0, so the published Pages docs report the real version.

Merged highlights in v0.12.0

Dependencies noted

Tagging checklist (for the maintainer)

  1. Merge this PR.
  2. Set the UNRELEASED date in CHANGELOG.md to the tag date.
  3. Tag v0.12.0 on master and push — setuptools_scm picks up the version, the
    wheel/publish job runs, and the rebuilt Pages docs report 0.12.
  4. Paste RELEASE_NOTES_v0.12.0.md into the GitHub Release.
  5. As the pending fix stack merges, append those entries to the changelog.

🤖 Generated with Claude Code

Resume the Keep a Changelog format (dormant since v0.8.10) with a v0.12.0
section, and add standalone GitHub release notes covering the changes since
v0.11.3 plus the pending fix stack.

Highlights: two offset data-loss fixes (#606/#707, #316/#692), the
re-added confluent-kafka driver, Python 3.14 support (3.8/3.9 dropped),
OpenTracing/OpenTelemetry made optional, and a live-broker CI harness.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HHPL4VFWQRQPpjR1gXSKyL
@codecov

codecov Bot commented Jul 19, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.15%. Comparing base (ade8a09) to head (645d942).

Additional details and impacted files
@@           Coverage Diff           @@
##           master     #708   +/-   ##
=======================================
  Coverage   94.15%   94.15%           
=======================================
  Files         104      104           
  Lines       11136    11136           
  Branches     1201     1201           
=======================================
  Hits        10485    10485           
  Misses        550      550           
  Partials      101      101           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

wbarnha and others added 3 commits July 19, 2026 12:14
PR #683 (codecov.yml with a 1% coverage threshold) was closed without
merging, so remove it from the changelog and release notes to keep the
v0.12.0 change list accurate.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HHPL4VFWQRQPpjR1gXSKyL
`docs/conf.py` hardcoded `version_dev='1.1'` / `version_stable='1.0'` -
robinhood-era values that never matched faust-streaming's 0.x line, so the
published GitHub Pages docs advertised the wrong version.

Derive the documented major.minor from `faust.__version__` (which
setuptools_scm resolves from the git tag), so the docs always report the real
version and this can't silently drift between releases.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HHPL4VFWQRQPpjR1gXSKyL
@wbarnha wbarnha changed the title docs: prepare v0.12.0 release notes and changelog docs: prepare v0.12.0 release notes, changelog, and docs version Jul 19, 2026
wbarnha and others added 4 commits July 19, 2026 12:56
Per review, the v0.12.0 changelog/release notes should describe only what is
already on master, not work still in open PRs.

- Remove the not-yet-merged items: the offset-commit data-loss fixes
  (#606/#707, #316/#692), the optional OpenTracing/OpenTelemetry extras
  (#685/#686, #688/#681), web_application_options (#704), and the reported-issue
  fix stack (#693-#703, #705). These will be added back as they merge.
- Add a Dependencies section noting the current runtime/client libraries:
  mode-streaming >= 0.4.0, aiokafka >= 0.10.0 (compatible with recent 0.13/0.14
  releases), the new confluent-kafka >= 2.0.0 for faust[ckafka], and the
  faust-cchardet fork replacing unmaintained cchardet.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HHPL4VFWQRQPpjR1gXSKyL
Replace the UNRELEASED placeholder with the release date and drop the
now-satisfied "set the date at tag time" note.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HHPL4VFWQRQPpjR1gXSKyL
@wbarnha
wbarnha merged commit 3f8e190 into master Jul 19, 2026
22 of 23 checks passed
@wbarnha
wbarnha deleted the claude/release-v0.12.0-prep branch July 19, 2026 18:27
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