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

Add Feature Flag Migration guide to docs #4792

Merged
merged 38 commits into from
Sep 22, 2023
Merged
Changes from 1 commit
Commits
Show all changes
38 commits
Select commit Hold shift + click to select a range
81314f6
Create feature-flag-migration-best-practices.md
ardeche07 Sep 20, 2023
361f77a
Create feature-flag-migration-scope.md
ardeche07 Sep 20, 2023
3c8e44f
Create business-case-feature-flag-migration.md
ardeche07 Sep 20, 2023
f191ff4
Create planning-feature-flag-migration.md
ardeche07 Sep 20, 2023
f96a242
Create how-to-execute-feature-flag-migration.md
ardeche07 Sep 20, 2023
499949d
Create onbording-users-to-feature-flag-service.md
ardeche07 Sep 20, 2023
1071696
Update feature-flag-migration-scope.md
ardeche07 Sep 20, 2023
cb236ed
Update feature-flag-migration-scope.md
ardeche07 Sep 20, 2023
4815a46
Update business-case-feature-flag-migration.md
ardeche07 Sep 20, 2023
97ea72d
Update planning-feature-flag-migration.md
ardeche07 Sep 20, 2023
8905801
Update how-to-execute-feature-flag-migration.md
ardeche07 Sep 20, 2023
11429d2
Update sidebars.js
ardeche07 Sep 20, 2023
3192a21
Update sidebars.js
ardeche07 Sep 20, 2023
38ee15a
Update website/docs/topics/feature-flag-migration/business-case-featu…
ardeche07 Sep 20, 2023
4a4eb92
Update website/docs/topics/feature-flag-migration/feature-flag-migrat…
ardeche07 Sep 20, 2023
b44b832
Update feature-flag-migration-scope.md
ardeche07 Sep 20, 2023
03dbc38
Update website/docs/topics/feature-flag-migration/feature-flag-migrat…
ardeche07 Sep 20, 2023
b099b4d
Update website/docs/topics/feature-flag-migration/feature-flag-migrat…
ardeche07 Sep 20, 2023
058c48b
Update website/docs/topics/feature-flag-migration/planning-feature-fl…
ardeche07 Sep 20, 2023
907fe70
Update website/docs/topics/feature-flag-migration/planning-feature-fl…
ardeche07 Sep 20, 2023
e7e636e
Update website/docs/topics/feature-flag-migration/planning-feature-fl…
ardeche07 Sep 20, 2023
42f7dcd
Update website/docs/topics/feature-flag-migration/planning-feature-fl…
ardeche07 Sep 20, 2023
33b0a4d
Update sidebars.js
ardeche07 Sep 20, 2023
655e5d3
Update website/sidebars.js
ardeche07 Sep 20, 2023
9f979f3
Update website/sidebars.js
ardeche07 Sep 20, 2023
6791a4d
Update sidebars.js
ardeche07 Sep 20, 2023
54ab011
Fix sidebars
gastonfournier Sep 20, 2023
63a3628
Fixes with Michael
gastonfournier Sep 20, 2023
e0dd224
Merge remote-tracking branch 'origin/main' into patch-3
gastonfournier Sep 20, 2023
bee13e7
Some fixes
gastonfournier Sep 20, 2023
7a85faa
Update website/docs/topics/feature-flag-migration/feature-flag-migrat…
ardeche07 Sep 21, 2023
5cff390
Update website/docs/topics/feature-flag-migration/business-case-featu…
ardeche07 Sep 21, 2023
bfd838d
Update website/docs/topics/feature-flag-migration/feature-flag-migrat…
ardeche07 Sep 21, 2023
ad7fd7d
Update website/docs/topics/feature-flag-migration/feature-flag-migrat…
ardeche07 Sep 21, 2023
ebb8f96
Update website/docs/topics/feature-flag-migration/how-to-execute-feat…
ardeche07 Sep 21, 2023
08e1f5c
Update website/docs/topics/feature-flag-migration/planning-feature-fl…
ardeche07 Sep 21, 2023
1444df5
Update website/sidebars.js
markunl Sep 22, 2023
2dc80a2
Merge branch 'main' into patch-3
thomasheartman Sep 22, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Create how-to-execute-feature-flag-migration.md
ardeche07 authored Sep 20, 2023
commit f96a242d7893763e4b8b8a04c78e674327879484
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
### Migration Execution
gastonfournier marked this conversation as resolved.
Show resolved Hide resolved

Now that we have completed the planning, below are some of our Best Practices for carrying out the migration based on our experience.

First, it can help to break the migration down into an order of activities, for example:

* **Minimum Viable Product (MVP) launch**
* Platform implemented, passed security/change management requirements, and available for developer use
* Rollout to the highest priority groups of users
* Matching use cases of the legacy platform
* Legacy system fallback available
* **Medium-term**
* Rollout to additional groups, adoption of further, less critical use cases
ardeche07 marked this conversation as resolved.
Show resolved Hide resolved
* Sunset of legacy system
* **Longer term**
* Adoption of new use cases

For each activity, plan for the Level of Effort (LoE), or the number of hours/days the task will take the assigned resource or group to fulfill.

Next up is risk handling. **Are there any perceived risks to the timelines that could be addressed upfront?**

* Have the teams involved with the migration committed to set hours for working the migration tasks upfront, have had migration project success criteria and their tasks communicated to them, and Q&A fulfilled?
* How long are various sign-offs by any relevant groups expected to take?
* E.g. Change Advisory Board, Security Controls, hardening checks, etc
* Plan to exceed each team’s documentation requirements to ensure fewer Requests for Information

Every step of the way, it can help to conduct reviews and look-backs at each rollout stage as well as what lies ahead.