Precision about media files

Author: NolwennP

content/img/illustrations/illus--Recordmediafile.svg renamed to content/img/illustrations/illus--Referenceentitymediafile.svg

@@ -1,7 +1,7 @@
 get:
-  summary: Get a list of media files
+  summary: Get a list of product media files
   operationId: "get_media_files"
-  description: This endpoint allows you to get a list of media files.
+  description: This endpoint allows you to get a list of media files that are used as attribute values in products or product models.
   tags:
     - Product media file
   x-versions:
@@ -118,7 +118,7 @@ get:
     406:
       $ref: "#/responses/406Error"
 post:
-  summary: Create a new media file
+  summary: Create a new product media file
   operationId: "post_media_files"
   description: This endpoint allows you to create a new media file and associate it to an attribute value of a given product or product model.
   tags:

content/swagger/resources/media_files/routes/media_files.yaml

@@ -1,7 +1,7 @@
 get:
-  summary: Get a media file
+  summary: Get a product media file
   operationId: "get_media_files__code_"
-  description: This endpoint allows you to get the information about a given media file.
+  description: This endpoint allows you to get the information about a given media file that is used as an attribute value of a product or a product model.
   tags:
     - Product media file
   x-versions:

content/swagger/resources/media_files/routes/media_files_code.yaml

@@ -1,7 +1,7 @@
 get:
-  summary: Download a media file
+  summary: Download a product media file
   operationId: "get_media_files__code__download"
-  description: This endpoint allows you to download a given media file.
+  description: This endpoint allows you to download a given media file that is used as an attribute value of a product or a product model.
   x-content-type: Mime-type of the media file
   tags:
     - Product media file

content/swagger/resources/media_files/routes/media_files_code_download.yaml

@@ -1,9 +1,9 @@
 post:
-  summary: Create a new record media file
+  summary: Create a new media file for a reference entity or a record
   operationId: "post_reference_entity_media_files"
-  description: This endpoint allows you to create a new media file and associate it to the main image or to an attribute value of a record of a reference entity.
+  description: This endpoint allows you to create a new media file and associate it to the image of a reference entity, or to the main image or to an attribute value of a record.
   tags:
-    - Record media file
+    - Reference entity media file
   x-versions:
     - "3.0"
   x-ee: true
@@ -21,11 +21,11 @@ post:
         properties:
           file:
             type: string
-            description: The binary of the record media file
+            description: The binary of the rmedia file
             format: binary
   responses:
     201:
-      $ref: "#/responses/RecordMediaFileUploaded"
+      $ref: "#/responses/ReferenceEntityMediaFileUploaded"
     401:
       $ref: "#/responses/401Error"
     415:

content/swagger/resources/reference_entity_media_files/routes/reference_entity_media_files.yaml

@@ -1,10 +1,10 @@
 get:
-  summary: Download a record media file
+  summary: Download the media file associated to a reference entity or a record
   operationId: "get_reference_entity_media_files__code"
-  description: This endpoint allows you to download a given record media file.
+  description: This endpoint allows you to download a given media file that is associated with a reference entity or a record.
   x-content-type: Mime-type of the media file
   tags:
-    - Record media file
+    - Reference entity media file
   x-versions:
     - "3.0"
   x-ee: true
@@ -13,8 +13,8 @@ get:
   responses:
     200:
       description: OK
-      x-details: Returns the binary of the record media file
-      x-content-type: Mime-type of the record media file
+      x-details: Returns the binary of the media file
+      x-content-type: Mime-type of the media file
     401:
       $ref: "#/responses/401Error"
     404:

content/swagger/resources/reference_entity_media_files/routes/reference_entity_media_files_code.yaml

@@ -5,15 +5,15 @@ Created:
     Location:
       description: URI of the created resource
       type: string
-RecordMediaFileUploaded:
+ReferenceEntityMediaFileUploaded:
   description: Created
-  x-details: Means that the record media file creation was successful
+  x-details: Means that the media file creation was successful
   headers:
     Location:
       description: URI of the created resource
       type: string
     Reference-entities-media-file-code:
-      description: Code of the record media file
+      description: Code of the media file
       type: string
 AssetReferenceFileUploaded:
   description: Uploaded

content/swagger/responses.yaml

@@ -208,9 +208,9 @@
                             <img class="img-responsive center-block" src="img/illustrations/illus--Referenceentityrecord.svg"></img>
                             <p class="text-center">Reference entity record</p>
                         </a>
-                        <a href="/api-reference-index.html#Recordmediafile" class="link-resource">
-                            <img class="img-responsive center-block" src="img/illustrations/illus--Recordmediafile.svg"></img>
-                            <p class="text-center">Record media file</p>
+                        <a href="/api-reference-index.html#Referenceentitymediafile" class="link-resource">
+                            <img class="img-responsive center-block" src="img/illustrations/illus--Referenceentitymediafile.svg"></img>
+                            <p class="text-center">Reference entity media file</p>
                         </a>
                         <a href="/api-reference-index.html#Asset" class="link-resource">
                             <img class="img-responsive center-block" src="img/illustrations/illus--Asset.svg"></img>

src/index.handlebars

@@ -44,7 +44,7 @@ function determineCategory(tag){
             return 'PAM';
         case 'Reference entity record':
         case 'Reference entity':
-        case 'Record media file':
+        case 'Reference entity media file':
         case 'Reference entity attribute':
         case 'Reference entity attribute option':
             return 'Reference entities';