Merge branch 'bmarjanovic/add-experiments-to-openapi-v2-documentation' into 'master'

Add Experiments to OpenAPI documetation

See merge request https://gitlab.com/gitlab-org/gitlab/-/merge_requests/103624



Merged-by: Pavel Shutsin <pshutsin@gitlab.com>
Approved-by: Alina Mihaila <amihaila@gitlab.com>
Approved-by: Pavel Shutsin <pshutsin@gitlab.com>
Co-authored-by: bmarjanovic <bmarjanovic@gitlab.com>

ee/lib/api/experiments.rb

@@ -7,8 +7,12 @@ class Experiments < ::API::Base
     feature_category :experimentation_expansion
 
     resource :experiments do
-      desc 'Get a list of all experiments' do
+      desc 'List all experiments' do
+        detail 'Get a list of all experiments. Each experiment has an enabled status that indicates whether'\
+          'the experiment is enabled globally, or only in specific contexts.'
         success EE::API::Entities::Experiment
+        is_array true
+        tags %w[experiments]
       end
       get do
         experiments = []

ee/lib/ee/api/entities/experiment.rb

@@ -4,7 +4,7 @@ module EE
   module API
     module Entities
       class Experiment < Grape::Entity
-        expose :key do |definition|
+        expose :key, documentation: { type: 'string', example: 'code_quality_walkthrough' } do |definition|
           definition.attributes[:name].gsub(/_experiment_percentage$/, '')
         end