11 principles page improvements #8704
Conversation
|
The latest updates on your projects. Learn more about Vercel for Git ↗︎
|
Dependency Review✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.OpenSSF Scorecard
Scanned Files |
website/docs/topics/feature-flags/feature-flag-best-practices.mdx
Outdated
Show resolved
Hide resolved
|
|
||
| Thank you for reading. Our motivation for writing these principles is to share what we've learned building a large-scale feature flag solution with other architects and engineers solving similar challenges. Unleash is open-source, and so are these principles. | ||
| Have something to contribute? [Open a PR](https://github.com/Unleash/unleash/pulls) or [discussion](https://github.com/orgs/Unleash/discussions) on our GitHub. | ||
|
|
There was a problem hiding this comment.
I would get rid of everything after this line
I'm not sure we want to give people even more information that they haven't asked for, but we could put a link to our pricing page if they're curious
There was a problem hiding this comment.
It was a suggestion from Ercule to add this section on additional resources: https://docs.google.com/document/d/1aCf0leHvrB9sVjeG3N0icPcUo7y5FcgZz03qX5JvL1Y/edit?tab=t.0
Given it's a page that drives a lot of traffic, I think it makes sense to give people some ideas of where to go next to learn more. The pricing page feels a bit too direct
|
|
||
| Avoid using feature flags for static application configuration. Application configuration should be consistent, long-lived, and loaded during application startup. In contrast, feature flags should be short-lived, dynamic, and updated at runtime. They prioritize availability over consistency and can be modified frequently. | ||
|
|
||
| <table> |
There was a problem hiding this comment.
Did you prefer an HTML table just for ease of reading?
There was a problem hiding this comment.
Well we have lists inside the cells, so it's either markdown + HTML vs pure HTML. I thought the latter was better for readability
|
LGTM, thank you @melindafekete |
Optimize the 11 principles page based on Ercule feedback. Key changes:
Page preview