Updated documentation based on review

app/views/projects/settings/ci_cd/_form.html.haml

@@ -92,10 +92,10 @@
           .form-check
             = f.check_box :forward_deployment_enabled, { class: 'form-check-input' }
             = f.label :forward_deployment_enabled, class: 'form-check-label' do
-              %strong= _("Drop older active deployments")
+              %strong= _("Skip older, pending deployment jobs")
             .form-text.text-muted
-              = _("When a deployment is successful, allow older but still pending deployment(s) to be skipped")
-              = link_to icon('question-circle'), help_page_path('user/project/pipelines/settings', anchor: 'drop-older-active-deployments'), target: '_blank'
+              = _("When a deployment job is successful, skip older deployment jobs that are still pending")
+              = link_to icon('question-circle'), help_page_path('user/project/pipelines/settings', anchor: 'skip-older-pending-deployment-jobs'), target: '_blank'
 
         %hr
         .form-group

doc/user/project/pipelines/settings.md

@@ -191,18 +191,24 @@ you can enable this in the project settings:
 1. Check the **Auto-cancel redundant, pending pipelines** checkbox.
 1. Click **Save changes**.
 
-## Drop older active deployments
+## Skip older, pending deployment jobs
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/25276) in GitLab 12.9.
 
-The number of pipelines running for your project can be important enough so that
-concurrent deployment jobs are scheduled to run within the same time frame.
+Your project may have multiple concurrent deployment jobs that are
+scheduled to run within the same time frame.
 
-This can lead to a situation where an older deployment job can be run after a
-newer one, which may not be a desired situation.
+This can lead to a situation where an older deployment job runs after a
+newer one, which may not be what you want.
 
-To avoid such scenario, check the **Drop older active deployments**
-checkbox and save the changes.
+To avoid this scenario:
+
+1. Go to **{settings}** **Settings > CI / CD**.
+1. Expand **General pipelines**.
+1. Check the **Skip older, pending deployment jobs** checkbox.
+1. Click **Save changes**.
+
+The pending deployment jobs will be skipped.
 
 ## Pipeline Badges
 

locale/gitlab.pot

@@ -7013,9 +7013,6 @@ msgstr ""
 msgid "Downvotes"
 msgstr ""
 
-msgid "Drop older active deployments"
-msgstr ""
-
 msgid "Due date"
 msgstr ""
 
@@ -17911,6 +17908,9 @@ msgstr ""
 msgid "Size settings for static websites"
 msgstr ""
 
+msgid "Skip older, pending deployment jobs"
+msgstr ""
+
 msgid "Skip this for now"
 msgstr ""
 
@@ -22046,7 +22046,7 @@ msgstr ""
 msgid "What are you searching for?"
 msgstr ""
 
-msgid "When a deployment is successful, allow older but still pending deployment(s) to be skipped"
+msgid "When a deployment job is successful, skip older deployment jobs that are still pending"
 msgstr ""
 
 msgid "When a runner is locked, it cannot be assigned to other projects"