diff --git a/website/docs/advanced/archived-toggles.md b/website/docs/advanced/archived-toggles.md index 1355b9f437..02f1fb6a5c 100644 --- a/website/docs/advanced/archived-toggles.md +++ b/website/docs/advanced/archived-toggles.md @@ -3,14 +3,18 @@ id: archived_toggles title: Archived toggles --- -In unleash you may choose to "archive" a feature toggle when it is not needed anymore. You do this by clicking the "Archive" button on the feature toggle details view. By archiving a feature toggle it will not be available to Client SDKs anymore. +You can _archive_ a feature toggle when it is not needed anymore. You do this by clicking the "Archive" button on the feature toggle details view. When you archive a feature toggle, it will no longer be available to Client SDKs. -![Archive Toggle](/img/archive-toggle.png 'Archiving a Feature Toggle'). +![The Unleash toggle view showing a focused "archive feature toggle" button, highlighted by a red arrow.](/img/archive-toggle.png 'Archiving a Feature Toggle'). -You will not be able to "fully delete a feature toggle". The reason for this is to avoid old toggles suddenly "waking up again". This could, in worst case, re-activate old functionality in code where the use of the feature toggle has not been cleaned up yet. +You can not "fully delete a feature toggle". This is to prevent you from creating a new feature toggle with the same name as an old one. This could potentially reactivate old functionality in code that still referenced the old toggle and result in unintended consequences. + +## Viewing archived toggles + +You can find archived toggles in the toggle archive. The archive is accessible from the global feature toggle list. ## Reviving a feature toggle {#reviving-a-feature-toggle} -If you want to re-use a feature toggle which has been archived you may revive in from the archive. You do that by clicking the "revive icon". Please not that revived toggles will be "disabled" when they are active again. +If you want to re-use a feature toggle that you previously archived, you can revive in from the feature toggle archive. Click the "revive icon" to revive the toggle. Revived toggles will be in the disabled state when you re-enable them. -![Revive Toggle](/img/archive-toggle-revive.png 'Reviving a Feature Toggle'). +![A list of archived toggles. Each toggle displays its name and project it belongs to. Each toggle also has a \"revive\" button, as highlighted by a red arrow.](/img/archive-toggle-revive.png 'Reviving a Feature Toggle'). diff --git a/website/static/img/archive-toggle-revive.png b/website/static/img/archive-toggle-revive.png index f674fa4c58..068fd7ac1f 100644 Binary files a/website/static/img/archive-toggle-revive.png and b/website/static/img/archive-toggle-revive.png differ diff --git a/website/static/img/archive-toggle.png b/website/static/img/archive-toggle.png index 69b412376c..e51fb83a89 100644 Binary files a/website/static/img/archive-toggle.png and b/website/static/img/archive-toggle.png differ