Update media.md

Author: salomegarnier

source/media.md

@@ -30,11 +30,11 @@ For hands-on practice with adding media attachments in XLSForm, see KoboToolbox
 
 To add media files to questions or notes in your XLSForm:
 1. Add a new question in the `survey` worksheet, specifying the **type**, **name**, and **label** (optional).
-        - Use a **note** question type if you want to display the media file without collecting any data (e.g., an             organization logo or introduction video).
-        - Adding a label is optional when including a media file.
+    - Use a **note** question type if you want to display the media file without collecting any data (e.g., an organization logo or introduction video).
+    - Adding a label is optional when including a media file.
 2. Add a column for the media you want to include. Name it `image`, `video`, or `audio`, depending on the media type. 
 3. In the media column, in the row of the question you have added, enter the exact name of the media file **including the extension**.
-        - For example: logo.png or intro.mp4.
+    - For example: `logo.png` or `intro.mp4`.
 
 **survey worksheet**
 
@@ -44,9 +44,11 @@ To add media files to questions or notes in your XLSForm:
 | survey |
 
 <p class="note">
-    <strong>Note:</strong> Previously, the format `media::file_type` was used for media column names (e.g., `media::image`, `media::video`, `media::audio`). The simplified format using only the media type without the `media::` prefix is now more commonly adopted (e.g., `image`, `video`, `audio`).
+    <strong>Note:</strong> Previously, the format <code>media::file_type</code> was used for media column names (e.g., <code>media::image</code>, <code>media::video</code>, <code>media::audio</code>). The simplified format using only the media type without the <code>media::</code> prefix is now more commonly adopted (e.g., <code>image</code>, <code>video</code>, <code>audio</code>).
 </p>
 
+### Uploading media files to KoboToolbox
+
 To upload the media files to KoboToolbox:
 1. Go to your [KoboToolbox account](https://www.kobotoolbox.org/sign-up/).
 2. In your KoboToolbox project, navigate to **SETTINGS > Media**.
@@ -60,10 +62,10 @@ To upload the media files to KoboToolbox:
 To add media files to option choices in your XLSForm:
 1. Add a [select type question](https://support.kobotoolbox.org/question_types_xls.html#select-question-types) in the `survey` worksheet.
 2. In the `choices` worksheet, add a **list_name**, **name**, and **label** (optional) for your choices.
-        - Adding a label is optional when including a media file. If you wish to use the media files as options          label, omit the label text.
+    - Adding a label is optional when including a media file. If you wish to use the media files as options label, omit the label text.
 3. Add a column for the media you want to include. Name it `image`, `video`, or `audio`, depending on the media type. 
 4. In the media column, in the row of the choices you have added, enter the name of the media file **including the extension**.
-        - For example: goat.png or fish.png
+    - For example: `goat.png` or `fish.png`
 
 **survey worksheet**
 
@@ -83,6 +85,8 @@ To add media files to option choices in your XLSForm:
 | animals | fish | Fish | fish.png |
 | choices |
 
+### Uploading media files to KoboToolbox
+
 To upload the media files to KoboToolbox:
 1. Go to your [KoboToolbox account](https://www.kobotoolbox.org/sign-up/).
 2. In your KoboToolbox project, navigate to **SETTINGS > Media**.
@@ -96,11 +100,11 @@ In XLSForms that are [translated in multiple languages](https://support.kobotool
 To add media files for different languages in your survey worksheet:
 
 1. Rename your media columns using the format **media_type::language (code)**, where `media_type` is the type of media file and `language` is the default language.
-        - For example: `image::English (en)`
+    - For example: `image::English (en)`
 2. Add a new media column for each translation language using the format **media_type::language (code)**. 
-        - For example: `audio::Spanish (es)`
+    - For example: `audio::Spanish (es)`
 3. In the media column for each language, enter the name of the media file you wish to include, including the extension.
-        - To use the same media file for each language, enter the file name from the default language column in the translation language column.
+    - To use the same media file for each language, enter the same file name as the one in the default language column.
 
 <p class="note">
     <strong>Note:</strong> If a media file is not listed in a translation column, it will not be displayed for that language. 
@@ -113,6 +117,8 @@ To add media files for different languages in your survey worksheet:
 | note | intro | Before you answer the form, watch the video below: | intro.mp4 | intro_ny.mp4 |
 | survey |
 
+### Uploading media files to KoboToolbox
+
 To upload the translated media files to KoboToolbox:
 1. Go to your [KoboToolbox account](https://www.kobotoolbox.org/sign-up/).
 2. In your KoboToolbox project, navigate to **SETTINGS > Media**.
@@ -127,18 +133,18 @@ To upload the translated media files to KoboToolbox:
 
 <details>
 <summary><strong>Error when deploying or viewing form</strong></summary>
-<br>
-    If you face an error when deploying or viewing your form, check the following:
+If you face an error when deploying or viewing your form, check the following:
     <ul>
       <li>The media file has been uploaded to KoboToolbox in the <strong>Media</strong> tab of the <strong>SETTINGS</strong> page.</li>
       <li>The file name in your XLSForm matches the media file name and extension exactly.</li>
     </ul>
 </details>
 
+<br>
+
 <details>
 <summary><strong>Media files not appearing in deployed form</strong></summary>
-<br>
-    If media files are not appearing in your deployed form, check the following:
+If media files are not appearing in your deployed form, check the following:
     <ul>
       <li>The media file has been uploaded to KoboToolbox in the <strong>Media</strong> tab of the <strong>SETTINGS</strong> page.</li>
       <li>The file name in your XLSForm matches the media file name and extension exactly.</li>
@@ -147,29 +153,38 @@ To upload the translated media files to KoboToolbox:
     </ul>
 </details>
 
+<br>
+
 <details>
 <summary><strong>Changing the size of a media file</strong></summary>
 To control the size of images displayed in your questions or choices, you must upload media files with the desired dimensions. Note that using very large files can increase loading times in Enketo forms.
 </details>
 
+<br>
+
 <details>
 <summary><strong>Form takes a long time to load</strong></summary>
-<br>
-    Enketo forms will load slowly if your media files are large. Reduce the size of image, video, or audio files before uploading them to the server to improve loading times.
+Enketo forms will load slowly if your media files are large. Reduce the size of image, video, or audio files before uploading them to the server to improve loading times.
 </details>
 
+<br>
+
 <details>
-    <summary><strong>Changing alignment of media files</strong></summary>
-    Media in KoboToolbox forms is center-aligned by default, and custom alignment (left or right) is not possible.  
+<summary><strong>Changing alignment of media files</strong></summary>
+Media in KoboToolbox forms is center-aligned by default, and custom alignment (left or right) is not possible.  
 </details>
 
+<br>
+
 <details>
-    <summary><strong>Animated GIF files not supported</strong></summary>
-    Animated GIF files are not currently supported by either Enketo web forms or the KoboCollect Android app.
+<summary><strong>Animated GIF files not supported</strong></summary>
+Animated GIF files are not currently supported by either Enketo web forms or the KoboCollect Android app.
 </details>
 
+<br>
+
 <details>
-    <summary><strong>Unable to upload media file</strong></summary>
-    The maximum size for media uploads is 100 MB. Files exceeding this limit must be reduced in size before uploading.
+<summary><strong>Unable to upload media file</strong></summary>
+The maximum size for media uploads is 100 MB. Files exceeding this limit must be reduced in size before uploading.
 </details>