manage.get.gov/docs/developer/adding-feature-flags.md

Adding feature flags

Feature flags are booleans (stored in our DB as the WaffleFlag object) that programmatically disable/enable "features" (such as DNS hosting) for a specified set of users.

We use django-waffle for our feature flags. Waffle makes using flags fairly straight forward.

Adding feature flags through django admin

1. On the app, navigate to \admin.
2. Under models, click Waffle flags.
3. Click Add waffle flag.
4. Add the model as you would normally. Refer to waffle's documentation regarding attributes for more information on them.

Enabling the profile_feature flag

1. On the app, navigate to \admin.
2. Under models, click Waffle flags.
3. Click the profile_feature record. This should exist by default, if not - create one with that name.
4. (Important) Set the field Everyone to Unknown. This field overrides all other settings when set to anything else.
5. Configure the settings as you see fit.

Using feature flags as boolean values

Waffle provides a boolean called flag_is_active that you can use as you otherwise would a boolean. This boolean requires a request object and the flag name.

Using feature flags to disable/enable views

Waffle provides a decorator that you can use to enable/disable views. When disabled, the view will return a 404 if said user tries to navigate to it.