summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAchilleas Pipinellis <axil@gitlab.com>2019-05-17 18:00:47 +0000
committerAchilleas Pipinellis <axil@gitlab.com>2019-05-17 18:00:47 +0000
commit09cca25c10af845f04a42b49b690d3b250bf284f (patch)
tree218e61407afdf186758b22b7d60e68da1340cca6
parentcbef8f2d6af6eb792b47f34c179f14e134dfd627 (diff)
parente15c33fd06c44f9e188cd03b1f31e22d3030d4e5 (diff)
downloadgitlab-ce-09cca25c10af845f04a42b49b690d3b250bf284f.tar.gz
Merge branch 'mk/improve-feature-flag-example' into 'master'
Development docs: Improve feature flag example See merge request gitlab-org/gitlab-ce!25664
-rw-r--r--doc/development/rolling_out_changes_using_feature_flags.md11
1 files changed, 5 insertions, 6 deletions
diff --git a/doc/development/rolling_out_changes_using_feature_flags.md b/doc/development/rolling_out_changes_using_feature_flags.md
index 8d35a4ecee2..8e4e07c4319 100644
--- a/doc/development/rolling_out_changes_using_feature_flags.md
+++ b/doc/development/rolling_out_changes_using_feature_flags.md
@@ -65,15 +65,14 @@ the worst case scenario, which we should optimise for, our total cost is now 20.
If we had used a feature flag, things would have been very different. We don't
need to revert a release, and because feature flags are disabled by default we
don't need to revert and pick any Git commits. In fact, all we have to do is
-disable the feature, and _maybe_ perform some cleanup. Let's say that the cost
-of this is 1. In this case, our best case cost is 11: 10 to build the feature,
-and 1 to add the feature flag. The worst case cost is now 12: 10 to build the
-feature, 1 to add the feature flag, and 1 to disable it.
+disable the feature, and in the worst case, perform cleanup. Let's say that
+the cost of this is 2. In this case, our best case cost is 11: 10 to build the
+feature, and 1 to add the feature flag. The worst case cost is now 13: 10 to
+build the feature, 1 to add the feature flag, and 2 to disable and clean up.
Here we can see that in the best case scenario the work necessary is only a tiny
bit more compared to not using a feature flag. Meanwhile, the process of
-reverting our changes has been made significantly cheaper, to the point of being
-trivial.
+reverting our changes has been made significantly and reliably cheaper.
In other words, feature flags do not slow down the development process. Instead,
they speed up the process as managing incidents now becomes _much_ easier. Once