Skip to content

Clarify retry semantics, fault types, and transient-fault-detection requirement#1845

Open
sri-adarsh-kumar wants to merge 2 commits intozalando:mainfrom
sri-adarsh-kumar:fix/docs-retry-semantics-952
Open

Clarify retry semantics, fault types, and transient-fault-detection requirement#1845
sri-adarsh-kumar wants to merge 2 commits intozalando:mainfrom
sri-adarsh-kumar:fix/docs-retry-semantics-952

Conversation

@sri-adarsh-kumar
Copy link
Copy Markdown
Contributor

@sri-adarsh-kumar sri-adarsh-kumar commented Apr 4, 2026

Clarifies retry semantics around idempotency, fault types, and response-based retries in riptide-failsafe and spring-boot-autoconfigure READs.
Fixes socket-fault retry docs to correctly require transient-fault-detection instead of being standalone.
Adds consolidated resilience docs overview at docs/resilience.md.

Closes #952

sri-adarsh-kumar and others added 2 commits April 3, 2026 18:06
…sed retries

- Document that only safe/idempotent methods are retried on socket faults
- Document that connection faults are retried for all methods when
  transient-fault-detection.enabled=true (request never reached server)
- Document that response-based retries (e.g. 503) must be triggered
  explicitly via retry() route or RetryException
- Add 503 retry example to riptide-failsafe README
- Add retry semantics callout box to riptide-spring-boot-autoconfigure README
- Add retry trigger table to docs/resilience.md

Closes zalando#952

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Correct misleading claim that socket faults are retried automatically
  for idempotent methods without any extra config: this only applies
  when transient-fault-detection.enabled=true is also set
- Add explicit plain statement: retry: config alone does not enable
  automatic transport-fault retries
- Add 2-row behavior matrix in Spring Boot autoconfigure README
- Expand trigger table in docs/resilience.md with a Condition column
  making the transient-fault-detection requirement explicit per row

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@sri-adarsh-kumar sri-adarsh-kumar marked this pull request as draft April 4, 2026 10:17
@sri-adarsh-kumar sri-adarsh-kumar changed the title docs: clarify retry semantics, fault types, and transient-fault-detection requirement Clarify retry semantics, fault types, and transient-fault-detection requirement Apr 4, 2026
@sri-adarsh-kumar sri-adarsh-kumar marked this pull request as ready for review April 4, 2026 11:19
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 retry mechanic in a more detailed way

1 participant