Skip to content

docs: clarify when to use bindings instead of state management - #5469

Open
VictorMoni wants to merge 5 commits into
dapr:v1.19from
VictorMoni:docs/clarify-bindings-state-management-3691
Open

VictorMoni wants to merge 5 commits into
dapr:v1.19from
VictorMoni:docs/clarify-bindings-state-management-3691

Conversation

@VictorMoni

@VictorMoni VictorMoni commented Nov 3, 2026 •

Copy link
Copy Markdown

Description

Clarify when to use bindings instead of state management. Add a comparison table and an Azure Blob Storage example showing the difference between the common state API and binding-specific operations.

Qualify portability claims so switching binding types is not presented as requiring no application changes. Include the link to optional state-store features requested during review.

Issue reference

Fixes #3691

Checklist

  • Content commits include DCO sign-off
  • Read the contribution guide
  • Page references use Hugo ref shortcodes

Not applicable: No new files, folders, images, platform-specific commands, or alternative code/command examples are introduced.

Validation

  • Confirmed that both content commits include Signed-off-by trailers; the other two commits merge the target branch.
  • Reviewed the final diff and confirmed that the reviewer's requested link is included.
  • Full Hugo build, link validation, and layout tests have not been run locally. CI workflows are awaiting maintainer approval.

AI assistance: PR metadata was updated with OpenAI Codex.

Explain binding-specific capabilities, compare bindings with the state API,
and illustrate the choice using Azure Blob Storage. Qualify portability
claims so that changing binding types is not presented as unconditional.

Signed-off-by: Victor Moni <victor-moni@hotmail.com>
@VictorMoni
VictorMoni requested review from a team as code owners November 3, 2026 17:40
@CasperGN CasperGN self-assigned this Nov 3, 2026

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

Thanks so much @VictorMoni for your interest in Dapr and for taking the time to clarify this page 🙌 The new comparison table makes it clear when to use bindings and when to use state management, and the reworded intro bullets no longer suggest you can swap one binding type for another with no code changes. I checked the Azure Blob Storage example against the binding reference: it lists blobs by prefix and makes presigned SAS URLs, as the page says. I left one small nit inline ✨

Drafted with AI assistance and reviewed by me.

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.

Clarify in the Binding Overview what binding are and when to use them.

2 participants