diff options
Diffstat (limited to 'data/deprecations/templates/example.yml')
-rw-r--r-- | data/deprecations/templates/example.yml | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/data/deprecations/templates/example.yml b/data/deprecations/templates/example.yml new file mode 100644 index 00000000000..f665dd21530 --- /dev/null +++ b/data/deprecations/templates/example.yml @@ -0,0 +1,33 @@ +# This is a template for a feature deprecation +# A deprecation typically occurs when a feature or capability is planned to be removed in a future release. +# Deprecations should be announced at least two releases prior to removal. Any breaking changes should only be done in major releases. +# +# Below is an example of what a single entry should look like, it's required attributes, +# and what types we expect those attribute values to be. +# +# For more information please refer to the handbook documentation here: +# {{LINK TBD}} +# +# Please delete this line and above before submitting your merge request. + +- name: "Feature name" # The name of the feature to be deprecated + announcement_milestone: "XX.YY" # The milestone when this feature was first announced as deprecated. + announcement_date: "YYYY-MM-DD" # The date of the milestone release when this feature was first announced as deprecated + removal_milestone: "XX.YY" # The milestone when this feature is planned to be removed + body: | # Do not modify this line, instead modify the lines below. + <!-- START OF BODY COMMENT + + This area supports markdown. Delete this entire comment and replace it with your markdown content. + + Make sure to run `bin/rake gitlab:docs:compile_deprecations` locally before committing and pushing your changes. + + When ready, assign to your tech writer to review and merge. + + END OF BODY COMMENT --> + stage: # (optional - may be required in the future) String value of the stage that the feature was created in. e.g., Growth + tiers: # (optional - may be required in the future) An array of tiers that the feature is available in currently. e.g., [Free, Silver, Gold, Core, Premium, Ultimate] + issue_url: # (optional) This is a link to the deprecation issue in GitLab + documentation_url: # (optional) This is a link to the current documentation page + image_url: # (optional) This is a link to a thumbnail image depicting the feature + video_url: # (optional) Use the youtube thumbnail URL with the structure of https://img.youtube.com/vi/UNIQUEID/hqdefault.jpg + removal_date: # (optional - may be required in the future) YYYY-MM-DD format - the date of the milestone release when this feature is planned to be removed |