flagd icon indicating copy to clipboard operation
flagd copied to clipboard

[DOC] Add feature-flag evaluation section

Open toddbaert opened this issue 2 years ago • 6 comments

Change in the documentation

Our docs currently have a feature-flagging page, which is a bit sparse. That's partially because we link to our concepts in openfeature.dev , but there's probably a bit more flagd-specific stuff that could be added here. I propose a new section:

"Evaluating flags with flagd"

  • Discuss basics of evaluating flags with flagd, including identifying the flag, and supplying a context. Link to https://flagd.dev/architecture/#rpc-vs-in-process-evaluation and https://flagd.dev/reference/flag-definitions/. Do not go into too much detail here, we have lots of reference docs which go into fine details. Keep it high-level.
  • Discuss errors and egde cases (flag-not-found, type-mismatches, and float/int flag conversion)
  • Discuss events (how changing a flag definition in flagd will cause events to fire in implementing SDKs), link to https://openfeature.dev/docs/reference/concepts/events

toddbaert avatar Oct 05 '23 13:10 toddbaert

Hey @toddbaert, I would love to work on this.

justankiit avatar Oct 08 '23 13:10 justankiit

Sure, assigned!

toddbaert avatar Oct 08 '23 20:10 toddbaert

Ok @toddbaert, Should I have to add this above

Change in the documentation

Our docs currently have a feature-flagging page, which is a bit sparse. That's partially because we link to our concepts in openfeature.dev , but there's probably a bit more flagd-specific stuff that could be added here. I propose a new section:

"Evaluating flags with flagd"

  • Discuss basics of evaluating flags with flagd, including identifying the flag, and supplying a context. Link to https://flagd.dev/architecture/#rpc-vs-in-process-evaluation and https://flagd.dev/reference/flag-definitions/. Do not go into too much detail here, we have lots of reference docs which go into fine details. Keep it high-level.
  • Discuss errors and egde cases (flag-not-found, type-mismatches, and float/int flag conversion)
  • Discuss events (how changing a flag definition in flagd will cause events to fire in implementing SDKs), link to https://openfeature.dev/docs/reference/concepts/events

justankiit avatar Oct 12 '23 04:10 justankiit

By Creating a new Section

justankiit avatar Oct 12 '23 04:10 justankiit

Hey @kumarankit999 . I'm not sure I understand your question.

toddbaert avatar Oct 12 '23 12:10 toddbaert

How should I solve this issue, Can you elaborate the steps to solve this

justankiit avatar Oct 14 '23 15:10 justankiit