diff --git a/lib/gitlab/ci/config/node/global.rb b/lib/gitlab/ci/config/node/global.rb
index fec2fe564ac24534a045bb4479b9a2ec8ed15fd6..f92e1eccbcf4f0d2b32a3c03133d8f429acafab8 100644
--- a/lib/gitlab/ci/config/node/global.rb
+++ b/lib/gitlab/ci/config/node/global.rb
@@ -28,7 +28,7 @@ module Gitlab
             description: 'Configuration of stages for this pipeline.'
 
           node :types, Node::Stages,
-            description: 'Stages for this pipeline (deprecated key).'
+            description: 'Deprecated: stages for this pipeline.'
 
           node :cache, Node::Cache,
             description: 'Configure caching between build jobs.'
diff --git a/spec/lib/gitlab/ci/config/node/undefined_spec.rb b/spec/lib/gitlab/ci/config/node/undefined_spec.rb
index 4318dfe6e539e6803ba073cba8bce52cbd9e45c9..0c6608d906d6e2a59862757a5cf24e1d6cd3eb7f 100644
--- a/spec/lib/gitlab/ci/config/node/undefined_spec.rb
+++ b/spec/lib/gitlab/ci/config/node/undefined_spec.rb
@@ -27,13 +27,13 @@ describe Gitlab::Ci::Config::Node::Undefined do
       allow(entry).to receive(:default).and_return('some value')
     end
 
-    it 'returns default value for entry that is undefined' do
+    it 'returns default value for entry' do
       expect(undefined.value).to eq 'some value'
     end
   end
 
   describe '#undefined?' do
-    it 'is not a concrete entry that is defined' do
+    it 'is not a defined entry' do
       expect(undefined.defined?).to be false
     end
   end