Skip to content

Add 10.2.0 changelog and release notes - #13521

Open
cmcfarlen wants to merge 2 commits into
apache:10.2.xfrom
cmcfarlen:10.2.0-release-notes
Open

Add 10.2.0 changelog and release notes#13521
cmcfarlen wants to merge 2 commits into
apache:10.2.xfrom
cmcfarlen:10.2.0-release-notes

Conversation

@cmcfarlen

Copy link
Copy Markdown
Contributor

Generated CHANGELOG-10.2.0 from the 10.2.0 milestone (650 PRs) and added
the v10.2 sections to whats-new and upgrading.

Authored off 10.2.x rather than master, since master's copies of these docs
describe changes not in this release (e.g. ssl_multicert.yaml).

Discussion needed: #13102

#13102 (Fix connect attempt retries) changes retry limits to be selected by
HostDB state, so DOWN origins are no longer retried at all. I documented it
as a necessary incompatible change, on the grounds that the limits were not
previously applied per origin state as documented.

Two things worth confirming:

  • I could not find this on upstream/10.1.x — it still has the old
    two-way is_server_negative_cached() branch and no
    connect_attempts_max_retries_suspect_server record. If it did land there,
    the upgrade note should say so, since operators coming from a late 10.1.x
    would already have the new behavior.
  • Whether framing it as a deliberate incompatibility is the right call for a
    release that is otherwise meant to be compatible.

No Sphinx build locally; relying on CI for the docs build.

Generate CHANGELOG-10.2.0 from the 10.2.0 milestone and document the
release in whats-new and upgrading. The connect retry change (apache#13102)
is called out as a necessary incompatible change, since the retry
limits were not previously applied according to origin state.
Copilot AI lite review requested due to automatic review settings August 9, 2026 20:03

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds Apache Traffic Server v10.2.0 release documentation by introducing a new top-level changelog file and expanding the existing release-notes docs with v10.2 “what’s new” and upgrade guidance (including the HostDB-state-based origin retry behavior change).

Changes:

  • Added a generated CHANGELOG-10.2.0 for the 10.2.0 milestone.
  • Added a new “What’s New in ATS v10.2” section to the release notes.
  • Added a new “Upgrading to ATS v10.2” section describing incompatible/configuration changes.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
doc/release-notes/whats-new.en.rst Adds v10.2 “what’s new”, including new features/configuration/metrics/plugins/API highlights.
doc/release-notes/upgrading.en.rst Adds v10.2-specific upgrade notes, including the HostDB-state-based origin retry behavior change.
CHANGELOG-10.2.0 Adds the generated v10.2.0 changelog content.
Suppressed comments (1)

doc/release-notes/whats-new.en.rst:120

  • In the list of new records.yaml settings, this entry is formatted as a literal code span while the surrounding entries use :ts:cv:. Since this is a real config record, it should be :ts:cv: for consistent linking and indexing in the docs.
* :ts:cv:`proxy.config.http.per_client.connection.exempt_list`
* :ts:cv:`proxy.config.proxy_protocol.max_header_size`
* ``proxy.config.quic.server.token_key.filename``
* :ts:cv:`proxy.config.ssl.client.cert_compression.algorithms`
* :ts:cv:`proxy.config.ssl.server.cert_compression.algorithms`

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread doc/release-notes/whats-new.en.rst Outdated
Comment on lines +26 to +27
This version of |ATS| includes 1034 commits from 655 pull requests, with 44
contributors participating in this development cycle.
Comment thread doc/release-notes/whats-new.en.rst Outdated
Comment on lines +82 to +84
* :file:`sni.yaml` supports session ticket overrides.
* QUIC token secrets are configurable via
``proxy.config.quic.server.token_key.filename``.
The PR count was 655 before five stale milestone entries were dropped;
the changelog has 650. Use :ts:cv: for
proxy.config.quic.server.token_key.filename, which is documented on
10.2.x even though it is absent from master, where it was first checked.
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.

2 participants