Skip to content

docs(v2): document HTTP read and idle timeout settings - #430

Open
erka wants to merge 1 commit into
mainfrom
v2/server-http-timeouts
Open

erka wants to merge 1 commit into
mainfrom
v2/server-http-timeouts

Conversation

@erka

@erka erka commented Oct 27, 2026

Copy link
Copy Markdown
Collaborator

Add server.http_read_timeout and server.http_idle_timeout to the v2
configuration reference.

closes #429

Add server.http_read_timeout and server.http_idle_timeout to the v2
configuration reference.

closes #429

Signed-off-by: Roman Dmytrenko <rdmytrenko@gmail.com>
@erka
erka requested a review from a team as a code owner October 27, 2026 14:50

@github-actions github-actions Bot 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.

Verdict: request changes

The PR adds server.http_read_timeout and server.http_idle_timeout to the v2 configuration reference; the defaults (10s / 0s) and the "0s inherits http_read_timeout" semantics correctly match the implementing feature PR (flipt-io/flipt#6695). The one issue is the "Since" version: both rows are marked v2.15.0, but that release does not exist (latest v2 release is v2.14.1) and the feature PR is still open and unmerged, so the version is an unverified guess and the docs would ship options not present in any released Flipt.

docs/v2/configuration/overview.mdx

  • major (L173): Both new rows are marked "Since v2.15.0", but that release does not exist — the latest Flipt v2 release is v2.14.1 — and the feature that introduces these settings (flipt-io/flipt#6695) is still open and unmerged, so the ServerConfig on the v2 branch has no http_read_timeout/http_idle_timeout fields at all. Per this repo's docs reviewer persona, the docs must never guess: a specific introducing version is unverified until the feature ships. Since docs auto-deploy on merge to main, merging now would publish config keys that don't work on any released Flipt v2 version. Either confirm with the Flipt team that these will land in the v2.15.0 release and use exactly that version, or hold this PR until the feature merges and the introducing release is known (also applies to line 174 for http_idle_timeout).

🤖 Automated review by the Flipt PR review agent.

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

ty!

This branch has not been deployed

No deployments
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.

Document: feat(server): make HTTP read and idle timeout configurable

2 participants