Document the bound domain in provider initialization and domain-scoped providers

Open Beginner friendly
#1,405 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-2 days
Newbie friendliness
74/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Quiet
Domain
documentation

Research direction

Start with the existing provider/domain and provider-lifecycle documentation referenced in the issue, using related issues #1387 and #119 for context. Document that initialize can receive the bound domain, when it is useful, and what declaring a domain-scoped provider means. Done when the API's one-domain binding rule and both provider concepts are covered in the existing documentation.

Written by the indexing model from the issue text.

Description

documentation

The spec now supplies the bound domain to a provider's initialize function, and adds an opt-in domain-scoped provider declaration that the API enforces by binding such a provider to at most one domain. The conceptual docs should cover this so provider authors and users understand it.

What needs to happen
  • Document that initialize can receive the bound domain, and when a provider would use it (e.g. scoping a persistent cache)
  • Document the domain-scoped provider concept: what declaring it means, and that the API binds such a provider to at most one domain
  • Fit this into the existing provider/domain and provider-lifecycle docs rather than a standalone page
Related
  • #1387 (provider lifecycle guidance), #119 (init/shutdown docs)
Links
Dominant language
TypeScript
Stars
65
Forks
117
Avg merge
1d 11h
Merged PRs (30d)
41

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from open-feature/openfeature.dev

All issues in open-feature/openfeature.dev

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.