fix(specs): adjust style for banner descriptions (#4362)

Co-authored-by: Pierre Millot <pierre.millot@algolia.com>

Author: kai687

specs/common/schemas/IndexSettings.yml

@@ -1008,21 +1008,21 @@ facetOrdering:
       $ref: '#/values'
 
 widgets:
-  description: widgets returned from any rules that are applied to the current search.
+  description: Widgets returned from any rules that are applied to the current search.
   type: object
   additionalProperties: false
   properties:
     banners:
       $ref: '#/banners'
 
 banners:
-  description: banners defined in the merchandising studio for the given search.
+  description: Banners defined in the Merchandising Studio for a given search.
   type: array
   items:
     $ref: '#/banner'
 
 banner:
-  description: a search banner with image and url.
+  description: Banner with image and link to redirect users.
   type: object
   additionalProperties: false
   properties:
@@ -1032,15 +1032,15 @@ banner:
       $ref: '#/bannerLink'
 
 bannerLink:
-  description: link for a banner defined in merchandising studio.
+  description: Link for a banner defined in the Merchandising Studio.
   type: object
   additionalProperties: false
   properties:
     url:
       type: string
 
 bannerImage:
-  description: image of a search banner.
+  description: Image to show inside a banner.
   type: object
   additionalProperties: false
   properties:
@@ -1052,7 +1052,7 @@ bannerImage:
       type: string
 
 bannerImageUrl:
-  description: url for a search banner image.
+  description: URL for an image to show inside a banner.
   type: object
   additionalProperties: false
   properties: