Update Documentation Related to Translations

_components/video-player-data.md

@@ -0,0 +1,40 @@
+---
+title: "Video Player"
+lang: en
+inline_css: |
+---
+
+## Code
+
+Embedding the video player:
+
+```liquid
+{%raw%}{% include video-player-data.html
+    video-id="video-introduction"
+    yt-id="20SHvU2PKsM"
+%}{% endraw%}
+```
+
+### Parameters
+
+`yt-id="20SHvU2PKsM"`
+`yt-id-ad="1rBwxGMT9ZM"`
+: YouTube ID of the video, `-ad` for the audio described version
+
+`video-id="video-introduction"`
+: Unique identifier of the video, as used in video-metadata.yml & VTT files basenames.
+
+## Behaviour
+
+- Based on video id, the video player component automatically uses all related VTT files.
+- Captions/subtitles and descriptions in the language of the page are selected by default.
+- The user can still select any other available language in the video player interface, to see the captions/subtitles/descriptions in another language.
+- If the language of the page is supported by AblePlayer, the video player interface is displayed in that language.
+
+## Example
+
+{% include video-player-data.html
+  video-id="video-introduction"
+  yt-id="20SHvU2PKsM"
+%}
+

_components/video-player.md

@@ -1,14 +1,8 @@
 ---
-title: "Video Player"
+title: "Video Player (deprecated version)"
 lang: en
-# translators: # Uncomment (remove #) for translations, one - name line per translator.
-# - name: Translator 1
-# - name: Translator 2
-# contributors:
-# - name: Contributor 1
-# - name: Contributor 2
-footer: > # Text in footer in HTML
-  <p> This is the text in the footer </p>
+doc-note-type: deprecated
+doc-note-message-md: The template is deprecated.
 inline_css: |
 ---
 
@@ -60,4 +54,4 @@ It is possible to concatenate multiple sets of those subtitles using commas. See
 
 {% include video-player.html
            yt-id="20SHvU2PKsM"
-           %}
+           %}

_data/navigation.yml

@@ -17,6 +17,8 @@
     url: "/technical/integrating-resource/"
   - name: Navigation
     url: "/technical/navigation/"
+  - name: Translations
+    url: "/technical/translations/"
 - name:
     en: 'Create and Edit Documents'
   pages:
@@ -32,6 +34,8 @@
     url: "/writing/html/"
   - name: Images
     url: "/writing/images/"
+  - name: Videos
+    url: "/writing/videos/"
   - name: Stand-alone Resources
     url: "/writing/standalone-resources/"
 - name:
@@ -131,6 +135,8 @@
   - name: "Video Links"
     url: "/components/video-links/"
   - name: "Video Player"
+    url: "/components/video-player-data/"
+  - name: "Video Player (deprecated)"
     url: "/components/video-player/"
   - name: "Your Report"
     url: "/components/your-report/"

_data/video-metadata.yml

@@ -0,0 +1 @@
+../_external/data/video-metadata.yml