From d0d9bf4bdc74024880b12a271a1a2dc263ebe171 Mon Sep 17 00:00:00 2001 From: Matias Szylkowski Date: Tue, 10 Aug 2021 16:32:39 -0400 Subject: [PATCH 1/6] Add video documentation --- extensions/amp-video/0.1/amp-video.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/extensions/amp-video/0.1/amp-video.md b/extensions/amp-video/0.1/amp-video.md index 89d85514cd7c..b31cb3d2474b 100644 --- a/extensions/amp-video/0.1/amp-video.md +++ b/extensions/amp-video/0.1/amp-video.md @@ -156,6 +156,13 @@ Indicates the album/collection the video was taken from, specified as a string. Indicates the name/title of the video, specified as a string. If not provided, the Media Session API helper uses either the `aria-label` attribute or falls back to the page's title. +[filter formats="stories"] + +#### cache + +Indicates what video cache to fetch the sources from (eg: `cache="google"`). This will reduce your resources utilization +[/filter] + ## Analytics `amp-video` supports analytics out of the box. See [video analytics](../../amp-analytics/amp-video-analytics.md) for more information. From 003ea63b34959bc52c8da672c253dd8351c034cf Mon Sep 17 00:00:00 2001 From: Matias Szylkowski Date: Tue, 10 Aug 2021 16:34:16 -0400 Subject: [PATCH 2/6] More detail --- extensions/amp-video/0.1/amp-video.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/extensions/amp-video/0.1/amp-video.md b/extensions/amp-video/0.1/amp-video.md index b31cb3d2474b..53491f48a9ee 100644 --- a/extensions/amp-video/0.1/amp-video.md +++ b/extensions/amp-video/0.1/amp-video.md @@ -160,7 +160,7 @@ Indicates the name/title of the video, specified as a string. If not provided, t #### cache -Indicates what video cache to fetch the sources from (eg: `cache="google"`). This will reduce your resources utilization +Indicates what video cache to fetch the sources from (eg: `cache="google"`). This will reduce your server requests for video resources by using the cache to serve the sources when possible. [/filter] ## Analytics From 086cc81e58e85b02b879b87bc0ef434735e604df Mon Sep 17 00:00:00 2001 From: Matias Szylkowski Date: Tue, 10 Aug 2021 18:06:28 -0400 Subject: [PATCH 3/6] Added section on amp-story --- extensions/amp-story/amp-story.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/extensions/amp-story/amp-story.md b/extensions/amp-story/amp-story.md index cc07fa55fd3f..af0591595ef9 100644 --- a/extensions/amp-story/amp-story.md +++ b/extensions/amp-story/amp-story.md @@ -395,6 +395,20 @@ This same image can be used for both mobile portrait and landscape desktop using ``` +##### Optimize `amp-video` by using a video cache on origin documents + +The `` element on stories supports specifying a video cache to be used on origin documents through the attribute `cache`. +The video cache can serve copies of the video at multiple bitrates, reducing the server's workload on delivering videos. +The appropriate video quality plays on the story, according to the network conditions of the viewer. + +Example: + +```html + + + +``` + ##### `data-text-background-color` The `data-text-background-color` attribute highlights the text of the element with a specified color. To highlight the entire block, add this attribute directly to the text element. To only highlight the text, add the attribute and text to an inner . Note that works anywhere inside an ``, not just in ``. From a1fe4f917958e7245eabc17860b8d2c62246dcba Mon Sep 17 00:00:00 2001 From: Matias Szylkowski Date: Wed, 11 Aug 2021 17:06:06 -0400 Subject: [PATCH 4/6] Update extensions/amp-story/amp-story.md Co-authored-by: Gabriel Majoulet --- extensions/amp-story/amp-story.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/extensions/amp-story/amp-story.md b/extensions/amp-story/amp-story.md index af0591595ef9..d6e35d81092c 100644 --- a/extensions/amp-story/amp-story.md +++ b/extensions/amp-story/amp-story.md @@ -395,7 +395,7 @@ This same image can be used for both mobile portrait and landscape desktop using ``` -##### Optimize `amp-video` by using a video cache on origin documents +##### Optimize `amp-video` by using a free Google hosted video cache on origin documents The `` element on stories supports specifying a video cache to be used on origin documents through the attribute `cache`. The video cache can serve copies of the video at multiple bitrates, reducing the server's workload on delivering videos. From 5e0f903fd31711a9a86a4370dadde9591c383451 Mon Sep 17 00:00:00 2001 From: Matias Szylkowski Date: Thu, 12 Aug 2021 09:20:41 -0400 Subject: [PATCH 5/6] Updating documentation with approved language --- extensions/amp-story/amp-story.md | 6 +++--- extensions/amp-video/0.1/amp-video.md | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/extensions/amp-story/amp-story.md b/extensions/amp-story/amp-story.md index d6e35d81092c..c9b741383a30 100644 --- a/extensions/amp-story/amp-story.md +++ b/extensions/amp-story/amp-story.md @@ -397,9 +397,9 @@ This same image can be used for both mobile portrait and landscape desktop using ##### Optimize `amp-video` by using a free Google hosted video cache on origin documents -The `` element on stories supports specifying a video cache to be used on origin documents through the attribute `cache`. -The video cache can serve copies of the video at multiple bitrates, reducing the server's workload on delivering videos. -The appropriate video quality plays on the story, according to the network conditions of the viewer. +The `` element on stories supports the Google video cache to be used on origin documents through the attribute `cache="google"`. The video cache will fetch and store the video contents periodically, so that story requests to the cache can return a processed list of video sources for that origin video. The video cache reduces serving costs for videos, serving most requests from the Google infrastructure, and generating transcodes with different quality settings that adapt the bitrate to the network conditions. + +Use 720p videos or higher to take advantage of all the video transcodes and adaptive bitrate algorithms. Example: diff --git a/extensions/amp-video/0.1/amp-video.md b/extensions/amp-video/0.1/amp-video.md index 53491f48a9ee..a2f8a97fa5f7 100644 --- a/extensions/amp-video/0.1/amp-video.md +++ b/extensions/amp-video/0.1/amp-video.md @@ -160,7 +160,7 @@ Indicates the name/title of the video, specified as a string. If not provided, t #### cache -Indicates what video cache to fetch the sources from (eg: `cache="google"`). This will reduce your server requests for video resources by using the cache to serve the sources when possible. +Indicates the Google video cache should store and serve the video by adding `cache="google"`. The video cache will fetch and store the video contents periodically, reducing serving costs for videos, and generating transcodes with different quality settings that adapt the bitrate to the network conditions. [/filter] ## Analytics From 86e1e283cd2d173f8134d6b69f1a82174aa39dc5 Mon Sep 17 00:00:00 2001 From: Matias Szylkowski Date: Fri, 3 Sep 2021 12:12:40 -0400 Subject: [PATCH 6/6] Simplify amp-story.md --- extensions/amp-story/amp-story.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/extensions/amp-story/amp-story.md b/extensions/amp-story/amp-story.md index c9b741383a30..2254aefd62a9 100644 --- a/extensions/amp-story/amp-story.md +++ b/extensions/amp-story/amp-story.md @@ -397,7 +397,7 @@ This same image can be used for both mobile portrait and landscape desktop using ##### Optimize `amp-video` by using a free Google hosted video cache on origin documents -The `` element on stories supports the Google video cache to be used on origin documents through the attribute `cache="google"`. The video cache will fetch and store the video contents periodically, so that story requests to the cache can return a processed list of video sources for that origin video. The video cache reduces serving costs for videos, serving most requests from the Google infrastructure, and generating transcodes with different quality settings that adapt the bitrate to the network conditions. +The `` element on stories supports the Google video cache to be used on origin documents through the attribute `cache="google"`. The video cache will fetch and store the video contents periodically, reducing serving costs for videos, and generating transcodes with different quality settings that adapt the bitrate to the network conditions. Use 720p videos or higher to take advantage of all the video transcodes and adaptive bitrate algorithms.