diff --git a/docs/assets/reportcard.png b/docs/assets/reportcard.png new file mode 100644 index 0000000000..3f6f41133b Binary files /dev/null and b/docs/assets/reportcard.png differ diff --git a/docs/assets/reporting.png b/docs/assets/reporting.png new file mode 100644 index 0000000000..ab4039c5dd Binary files /dev/null and b/docs/assets/reporting.png differ diff --git a/docs/assets/togglelist.png b/docs/assets/togglelist.png new file mode 100644 index 0000000000..bba0055f46 Binary files /dev/null and b/docs/assets/togglelist.png differ diff --git a/docs/deploy/technical-debt.md b/docs/deploy/technical-debt.md new file mode 100644 index 0000000000..b6bac57e27 --- /dev/null +++ b/docs/deploy/technical-debt.md @@ -0,0 +1,34 @@ +--- +id: technical_debt +title: Technical Debt +--- + +At Unleash we care deeply about code quality. Technical debt creeps up over time and slowly builds to the point where it really starts to hurt. At that point it's too late. Feature toggles that have outlived their feature and are not cleaned up represent technical dept that should be cleaned up and removed from your code. + +In order to assist with removing unused feature toggles, Unleash provides a technical debt dashboard in the management-ui. You can find it by opening up the sidebar in the management ui and clicking on the _reporting_ menu item. + +![Technical debt](../assets/reporting.png) + +The dasboard includes a health report card, and a list of toggles that can be filtrated on different parameters. + +## Report card + +![Report card](../assets/reportcard.png) + +The report card includes some statistics of your application. It lists the overall amount of your active toggles, the overall amount of stale toggles, and lastly, the toggles that Unleash believes should be stale. This calculation is performed on the basis of toggle types: + +- **Release** - Used to enable trunk-based development for teams practicing Continuous Delivery. _Expected lifetime 40 days_ +- **Experiment** - Used to perform multivariate or A/B testing. _Expected lifetime 40 days_ +- **Operational** - Used to control operational aspects of the system's behavior. _Expected lifetime 7 days_ +- **Kill switch** - Used to to gracefully degrade system functionality. _(permanent)_ +- **Permission** - Used to change the features or product experience that certain users receive. _(permanent)_ + +If your toggle exceeds the expected lifetime of it's toggle type it will be marked as _potentially stale_. + +Your overall health rating is calculated based on the total amount of toggles and how many stale and potentially stale toggles you have in your project. One thing to note is that the report card and corresponding list are showing stats related to the currently selected project. If you have more than one project, you will be provided with a project selector in order to swap between the projects. + +## Toggle list + +![Toggle list](../assets/togglelist.png) + +The toggle list gives an overview over all of your toggles and their status. In this list you can sort the toggles by their name, last seen, created, expired, status and report. This will allow you to quickly get an overview over which toggles may be worth deprecating and removing from the code. diff --git a/docs/user_guide/discover-unknown-toggles.md b/docs/user_guide/discover-unknown-toggles.md index 302d46caf1..8a24817901 100644 --- a/docs/user_guide/discover-unknown-toggles.md +++ b/docs/user_guide/discover-unknown-toggles.md @@ -1,5 +1,5 @@ --- -id: discover_unkonwn_toggles +id: discover_unknown_toggles title: Discover unknown toggles --- diff --git a/website/i18n/en.json b/website/i18n/en.json index 60e84afd4e..64be53cd15 100644 --- a/website/i18n/en.json +++ b/website/i18n/en.json @@ -125,6 +125,9 @@ "deploy/securing_unleash": { "title": "Securing Unleash" }, + "deploy/technical_debt": { + "title": "Technical Debt" + }, "developer_guide": { "title": "Developer guide" }, @@ -179,7 +182,7 @@ "user_guide/create_feature_toggle": { "title": "Create a feature toggle" }, - "user_guide/discover_unkonwn_toggles": { + "user_guide/discover_unknown_toggles": { "title": "Discover unknown toggles" }, "user_guide/index": { diff --git a/website/sidebars.json b/website/sidebars.json index f0273e4b40..90d934592a 100644 --- a/website/sidebars.json +++ b/website/sidebars.json @@ -65,7 +65,8 @@ "deploy/google_auth", "deploy/database_backup", "deploy/migration_guide", - "deploy/import_export" + "deploy/import_export", + "deploy/technical_debt" ] }, "Integrations": {