Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Newsletter: Feature flag mistakes to avoid #10302

Open
wants to merge 4 commits into
base: master
Choose a base branch
from

Conversation

ivanagas
Copy link
Contributor

@ivanagas ivanagas commented Jan 8, 2025

Changes

Draft of a feature flag mistakes to avoid newsletter. Would love feedback on:

  • Have a missed any mistakes?
  • Are they in the correct order?
  • Any better examples I could use?
  • Suggestions for a conclusion?
  • How can I improve the intro?

Checklist

  • Words are spelled using American English
  • Titles are in sentence case
  • Feature names are in sentence case too
  • Use relative URLs for internal links

Article checklist

  • I've added (at least) 3-5 internal links to this new article
  • I've added keywords for this page to the rank tracker in Ahrefs
  • I've checked the preview build of the article
  • The date on the article is today's date
  • I've added this to the relevant "Tutorials and guides" docs page (if applicable)

Copy link

vercel bot commented Jan 8, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Updated (UTC)
posthog ✅ Ready (Inspect) Visit Preview Jan 10, 2025 6:30pm

@charlescook-ph
Copy link
Collaborator

As is tradition, I only have title-y type feedback. I think it's a bit dry - can we try something like 'Feature flag mistakes we've made at PostHog' (and how you can avoid them) or 'Non-obvious feature flag mistakes to avoid'?

Not super helpful, but the first one 'not using them' just feels a classic clickbaity/listicle item. But I don't have something helpful to suggest to improve this so maybe it's fine!

@ivanagas
Copy link
Contributor Author

The option "Feature flag mistakes to avoid" was the highest voted option in a newsletter poll we ran FYI.

Copy link
Contributor

@andyvan-ph andyvan-ph left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is tight and very actionable. Additional high-level thoughts:

  • I think, in the intro, we need to connect using feature flags with our broader theme of product engineering. You kind of touch on it, but it should be super explicit that mastering feature flags is a key skill in becoming a good product engineer. I think you could probably start there – i.e. "We're always banging about how product engineers need to XYZ XYZ and feature flags are a key too."

  • Agree with Charles the headline. I view the polls as more topic testing than headline testing. We don't need to go crazy here, but it could do with a little something extra.

contents/newsletter/feature-flag-mistakes.md Outdated Show resolved Hide resolved
contents/newsletter/feature-flag-mistakes.md Outdated Show resolved Hide resolved
contents/newsletter/feature-flag-mistakes.md Outdated Show resolved Hide resolved

The core of a feature flag's value to developers is the ability to turn them off. They need to be ready for this at any point, which isn't always the case.

![Shocked by feature flag](https://res.cloudinary.com/dmukukwp6/image/upload/turnoff_941966283f.png)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this would be a good one to turn into a Maxhog meme – I'm sure Lottie could dress Max in the pikachu costume! We could use this as the main image.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Requested: #10321

Co-authored-by: Bijan Boustani <[email protected]>
@ivanagas
Copy link
Contributor Author

ok, title and intro updated

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.

4 participants