SEO additions to VOD pages

apivideo · Oct 20, 2023 · e406a44 · e406a44
1 parent eab833b
commit e406a44
Show file tree

Hide file tree

Showing 38 changed files with 111 additions and 1,199 deletions.
diff --git a/templates/documentation/vod/README.md b/templates/documentation/vod/README.md
@@ -1,6 +1,5 @@
 ---
-title: "VOD overview"
-slug: "vod-overview"
+title: VOD overview
 hide_side_table_of_contents: true
 meta:
   description: This page serves as a foundational guide to integrating api.video's solutions for video on demand (VOD).

diff --git a/templates/documentation/vod/add-a-permanent-watermark.md b/templates/documentation/vod/add-a-permanent-watermark.md
@@ -1,9 +1,10 @@
 ---
-title: "Watermarks"
+title: Watermarks
+meta:
+    description: Learn how to apply permanent watermarks programmatically to videos uploaded to api.video.
 ---
 
-Add A Permanent Watermark
-=========================
+# Add A Permanent Watermark
 
 api.video gives you the ability to add permanent watermarks to your videos.
 

diff --git a/templates/documentation/vod/add-a-thumbnail-to-your-video.md b/templates/documentation/vod/add-a-thumbnail-to-your-video.md
@@ -1,8 +1,10 @@
 ---
-title: "Add a thumbnail to your video"
+title: Add a thumbnail to your video
+meta:
+    description: Learn how to add thumbnails programmatically or via the Dashboard to videos uploaded to api.video.
 ---
-Add A Thumbnail To Your Video
-=============================
+
+# Add A Thumbnail To Your Video
 
 For videos or recorded live streams, api.video offers you two ways to add a thumbnail:
 

diff --git a/templates/documentation/vod/add-captions.md b/templates/documentation/vod/add-captions.md
@@ -1,6 +1,5 @@
 ---
-title: "Adding captions"
-slug: "add-captions"
+title: Adding captions
 meta:
   description: This page gets users started on how to add captions to their videos using the api.video Captions endpoint.
 ---

diff --git a/templates/documentation/vod/amazon-cold-storage-backup.md b/templates/documentation/vod/amazon-cold-storage-backup.md
@@ -1,9 +1,9 @@
 ---
-title: "Backup your videos to Amazon S3"
-slug: "amazon-cold-storage-backup"
+title: Backup your videos to Amazon S3
 meta:
   description: Backup videos uploaded to api.video to Amazon Storage account with a simple script. 
 ---
+
 # Video backup to Amazon S3
 
 At [api.video](https://api.video/) we understand that sometimes, you want to make sure that your videos are safe and secure. Although api.video has a backup and disaster recovery plan, it’s up to you to decide if you want an extra backup resource or if you would like to use api.video just to transcode your videos but eventually store them on a different resource.

diff --git a/templates/documentation/vod/azure-cold-storage-backup.md b/templates/documentation/vod/azure-cold-storage-backup.md
@@ -1,9 +1,9 @@
 ---
-title: "Backup your videos to Azure"
-slug: "azure-cold-storage-backup"
+title: Backup your videos to Azure
 meta:
   description: Backup videos uploaded to api.video to Azure Storage account with a simple script. 
 ---
+
 # Video backup to Azure Storage account
 
 At [api.video](https://api.video/) we understand that sometimes, you want to make sure that your videos are safe and secure. Although api.video has a backup and disaster recovery plan, it’s up to you to decide if you want an extra backup resource or if you would like to use api.video just to transcode your videos but eventually store them on a different resource.

diff --git a/templates/documentation/vod/backup-and-cold-storage.md b/templates/documentation/vod/backup-and-cold-storage.md
@@ -1,6 +1,5 @@
 ---
-title: "api.video backup and cold storage"
-slug: "backup-and-cold-storage"
+title: api.video backup and cold storage
 meta:
   description: Backup your uploaded videos to your preferred provider.
 ---

diff --git a/templates/documentation/vod/clip-a-video.md b/templates/documentation/vod/clip-a-video.md
@@ -1,6 +1,5 @@
 ---
-title: "clip and trim videos with api.video"
-slug: "clip-a-video"
+title: clip and trim videos with api.video
 meta:
   description: Clip and trim a video while uploading to api.video
 ---

diff --git a/templates/documentation/vod/create-and-manage-webhooks.md b/templates/documentation/vod/create-and-manage-webhooks.md
diff --git a/templates/documentation/vod/creating-and-managing-chapters.md b/templates/documentation/vod/creating-and-managing-chapters.md
@@ -1,6 +1,5 @@
 ---
-title: "Create and manage chapters"
-slug: "create-manage-chapters"
+title: Create and manage chapters
 meta:
   description: This page gets users started on how to add chapters to their videos using the api.video Chapters endpoint.
 ---

diff --git a/templates/documentation/vod/delegated-upload-tokens.md b/templates/documentation/vod/delegated-upload-tokens.md
@@ -1,6 +1,5 @@
 ---
-title: "Delegated upload tokens"
-slug: "delegated-upload-tokens"
+title: Delegated upload tokens
 metadata: 
   description: This guide explains how to create, list, retrieve, and delete delegated upload tokens, and how to upload videos with them.
 ---

diff --git a/templates/documentation/vod/delete-a-video.md b/templates/documentation/vod/delete-a-video.md
@@ -1,8 +1,10 @@
 ---
-title: "Delete a video"
+title: Delete a video
+meta:
+    description: This guide walks you through how to permanently remove a video programmatically, and through the dashboard.
 ---
-Delete A Video
-==============
+
+# Delete A Video
 
 This guide walks you through how to permanently remove a video programmatically, and through the dashboard. Please be aware that you cannot retrieve a video you delete, so be sure it's what you want to do.
 

diff --git a/templates/documentation/vod/demo-loom-clone.md b/templates/documentation/vod/demo-loom-clone.md
@@ -1,5 +1,7 @@
 ---
-title: "Loom mockup"
+title: Loom mockup
+meta:
+    description: This guide explains how to create a Loom-like application with api.video.
 ---
 
 # Loom clone

diff --git a/templates/documentation/vod/demo-youtube-clone.md b/templates/documentation/vod/demo-youtube-clone.md
@@ -1,5 +1,7 @@
 ---
-title: "YouTube clone"
+title: YouTube clone
+meta:
+    description: This guide explains how to create a YouTube-like application with api.video.
 ---
 
 # YouTube mockup

diff --git a/templates/documentation/vod/demos-airbnb-clone.md b/templates/documentation/vod/demos-airbnb-clone.md
@@ -1,5 +1,7 @@
 ---
-title: "Airbnb clone"
+title: Airbnb clone
+meta:
+    description: This guide explains how to create an Airbnb-like application with api.video.
 ---
 
 # Airbnb mockup

diff --git a/templates/documentation/vod/demos-prog-upload-uploader.md b/templates/documentation/vod/demos-prog-upload-uploader.md
@@ -1,5 +1,7 @@
 ---
-title: "Progressive video uploader"
+title: Progressive video uploader
+meta:
+    description: This guide explains how to create an application than can handle video recording and upload in real-time with api.video.
 ---
 
 # Progressive video uploader

diff --git a/templates/documentation/vod/demos-template-overview.md b/templates/documentation/vod/demos-template-overview.md
@@ -1,3 +1,9 @@
+---
+title: Demos & templates
+meta:
+    description: This page lists demo applications and templates that you can use to develop your own video solution using api.video.
+---
+
 # Demos & Templates
 
 The amount of use cases you can build with [api.video](https://api.video/) is endless, however, sometimes, you need a little help in building your next amazing startup! That’s why we’ve created Templates to help you kickstart your application, without doing all the heavy lifting.
@@ -13,7 +19,7 @@ The Templates are structured in a way where you can:
 
 ## VOD Templates list
 
-* [Video uploader](/vod/upload-your-first-video.md)
+* [Video uploader](/vod/demos-video-uploader.md)
 * [Progressive video uploader](/vod/demos-prog-upload-uploader.md)
 * [Loom clone](/vod/demo-loom-clone.md)
 * [Youtube mockup](/vod/demo-youtube-clone.md)

diff --git a/templates/documentation/vod/demos-tiktok-clone.md b/templates/documentation/vod/demos-tiktok-clone.md
@@ -1,5 +1,7 @@
 ---
-title: "TikTok clone"
+title: TikTok clone
+meta:
+    description: This guide explains how to create a TikTok-like application with api.video.
 ---
 
 # TikTok mockup

diff --git a/templates/documentation/vod/demos-udemy-clone.md b/templates/documentation/vod/demos-udemy-clone.md
@@ -1,5 +1,7 @@
 ---
-title: "Udemy clone"
+title: Udemy clone
+meta:
+    description: This guide explains how to create a Udemy-like application with api.video.
 ---
 
 # Udemy mockup

diff --git a/templates/documentation/vod/demos-video-uploader.md b/templates/documentation/vod/demos-video-uploader.md
@@ -1,5 +1,7 @@
 ---
-title: "Video uploader"
+title: Video uploader
+meta:
+    description: This guide explains how to create a backend application than can handle video uploads with api.video.
 ---
 
 # Video uploader

diff --git a/templates/documentation/vod/downloading-videos.md b/templates/documentation/vod/downloading-videos.md
diff --git a/templates/documentation/vod/encoding-transcoding.md b/templates/documentation/vod/encoding-transcoding.md
@@ -1,9 +1,7 @@
 ---
-title: "Encoding and transcoding"
-slug: "encoding-transcoding"
-metadata: 
-  title: "Encoding and transcoding • api.video Documentation"
-  description: "This guide explains what video encoding and transcoding means and how api.video enables you to provide your users high quality videos via encoding and transcoding."
+title: Encoding and transcoding
+metadata:
+  description: This guide explains what video encoding and transcoding means and how api.video enables you to provide your users high quality videos via encoding and transcoding.
 ---
 
 ## Encoding

diff --git a/templates/documentation/vod/get-started-in-5-minutes.md b/templates/documentation/vod/get-started-in-5-minutes.md
@@ -1,8 +1,10 @@
 ---
-title: "Get Started with VOD in 5 Minutes"
+title: Get Started with VOD in 5 Minutes
+meta:
+  description: This quickstart guide explains the concept of building a video uploader and a video listing on the same page in just a few steps.
 ---
-Get Started In 5 Minutes
-========================
+
+# Get Started In 5 Minutes
 
 In order to get the concept of building on top of api.video, we've created a get started guide that will show you the concept of building a video uploader and a video listing on the same page. 
 

diff --git a/templates/documentation/vod/google-cold-storage-backup.md b/templates/documentation/vod/google-cold-storage-backup.md
@@ -1,9 +1,9 @@
 ---
-title: "Backup your videos to Google Storage account"
-slug: "google-cold-storage-backup"
+title: Backup your videos to Google Storage account
 meta:
-  description: Backup videos uploaded to api.video to Google Storage account with a simple script. 
+  description: Backup videos uploaded to api.video to Google Storage account with a simple script.
 ---
+
 # Video backup to Google Storage account
 
 At [api.video](https://api.video/) we understand that sometimes, you want to make sure that your videos are safe and secure. Although api.video has a backup and disaster recovery plan, it’s up to you to decide if you want an extra backup resource or if you would like to use api.video just to transcode your videos but eventually store them on a different resource.

diff --git a/templates/documentation/vod/list-videos-2.md b/templates/documentation/vod/list-videos-2.md
@@ -1,9 +1,10 @@
 ---
-title: "List videos"
+title: List videos
+meta:
+  description: This guide walks through the different options for retrieving videos and covers a method for searching for them using your dashboard.
 ---
 
-List Videos
-===========
+# List Videos
 
 You will often need to retrieve a list of all your videos or some videos to work with them. You might need to do this on the fly to see what you have, or you might want to pull the list into a database you can then pull from to create different kinds of displays. There are two ways to retrieve your videos: 
 

diff --git a/templates/documentation/vod/progressive-upload.md b/templates/documentation/vod/progressive-upload.md
@@ -1,8 +1,10 @@
 ---
-title: "Progressive video upload"
+title: Progressive video upload
+meta:
+  description: This guide walks through how progressive video upload works with api.video.
 ---
-Progressive video upload
-=============================
+
+# Progressive video upload
 
 api.video provides different ways to upload your videos. There are two ways to upload with tokens, and then there are two ways to upload depending on whether your video is over 200MB or under. This guide walks through how to do progressive video upload. Options covered in this guide include:
 

diff --git a/templates/documentation/vod/show-video-details.md b/templates/documentation/vod/show-video-details.md
@@ -1,9 +1,10 @@
 ---
-title: "Show video details"
+title: Show video details
+meta:
+  description: This guide explains how retrieve video details programmatically and through the api.video dashboard.
 ---
 
-Show Video Details
-==================
+# Show Video Details
 
 You can retrieve details for a specific video if you have the video ID. In this guide, we'll walk through the code to retrieve it and how to retrieve it from the dashboard.
 

diff --git a/templates/documentation/vod/show-video-upload-status.md b/templates/documentation/vod/show-video-upload-status.md
@@ -1,8 +1,10 @@
 ---
-title: "Video status & details"
+title: Video status & details
+meta:
+  description: This guide explains how retrieve the video upload and encoding status programmatically via the API and through webhooks.
 ---
-Video status & details
-======================
+
+# Video status & details
 
 api.video gives you ways of checking the video upload status and video details.
 

diff --git a/templates/documentation/vod/update-video-details.md b/templates/documentation/vod/update-video-details.md
@@ -1,8 +1,10 @@
 ---
-title: "Update video details"
+title: Update video details
+meta:
+  description: This guide explains the two methods you can use to update videos - programmatically and through the dashboard.
 ---
-Update Video Details
-====================
+
+# Update Video Details
 
 You can update details for a video after you've uploaded it. The only things you can't change are the video ID, the content of the video, and the watermark. This guide walks through two ways you can make an update - programmatically and through the dashboard.
 

diff --git a/templates/documentation/vod/upload-a-video-regular-upload.md b/templates/documentation/vod/upload-a-video-regular-upload.md
@@ -1,8 +1,10 @@
 ---
-title: "Regular video upload"
+title: Regular video upload
+meta:
+  description: This guide walks through how to upload videos under 200MiB in size programmatically with api.video.
 ---
-Regular video upload
-=============================
+
+# Regular video upload
 
 api.video provides different ways to upload your videos. There are two ways to upload with tokens, and then there are two ways to upload depending on whether your video is over 200MiB or under. This guide walks through how to do regular video upload for a video under 200MiB in size.
 

diff --git a/templates/documentation/vod/upload-from-source.md b/templates/documentation/vod/upload-from-source.md
@@ -1,5 +1,7 @@
 ---
-title: "Upload video from source"
+title: Upload video from source
+meta:
+  description: This guide walks through how to clone one of your existing videos, and upload videos via a URL with api.video.
 ---
 
 # Upload video from source