ampproject · britice · Jan 26, 2016
diff --git a/README.md b/README.md
@@ -86,14 +86,14 @@ These components can:
   such as [amp-img](builtins/amp-img.md) and [amp-video](builtins/amp-video.md).
 * Implement embedded third-party content, such as
 [amp-ad](builtins/amp-ad.md),
-[amp-pinterest](extensions/amp-pinterest/amp-pinterest.md),
-[amp-twitter](extensions/amp-twitter/amp-twitter.md),
-and [amp-youtube](extensions/amp-youtube/amp-youtube.md).
+[amp-pinterest](extensions/amp-pinterest/README.md),
+[amp-twitter](extensions/amp-twitter/README.md),
+and [amp-youtube](extensions/amp-youtube/README.md).
 * Provide for common patterns in web pages,
-such as [amp-lightbox](extensions/amp-lightbox/amp-lightbox.md)
-and [amp-carousel](extensions/amp-carousel/amp-carousel.md).
+such as [amp-lightbox](extensions/amp-lightbox/README.md)
+and [amp-carousel](extensions/amp-carousel/README.md).
 * Make advanced performance techniques easy,
-such as [amp-anim](extensions/amp-anim/amp-anim.md),
+such as [amp-anim](extensions/amp-anim/README.md),
 which allows web developers to dynamically serve animated images
 as either image files (GIF) or video files (WebM or MP4) based on browser compatibility.
 

diff --git a/builtins/amp-ad.md b/builtins/amp-ad.md
@@ -64,7 +64,7 @@ Optional attribute to pass configuration to the ad as an arbitrarily complex JSO
 
 ##### data-consent-notification-id
 
-Optional attribute. If provided will require confirming the [amp-user-notification](../extensions/amp-user-notification/amp-user-notification.md) with the given HTML-id until the "AMP client id" for the user (similar to a cookie) is passed to the ad. The means ad rendering is delayed until the user confirmed the notification.
+Optional attribute. If provided will require confirming the [amp-user-notification](../extensions/amp-user-notification/README.md) with the given HTML-id until the "AMP client id" for the user (similar to a cookie) is passed to the ad. The means ad rendering is delayed until the user confirmed the notification.
 
 #### Placeholder
 

diff --git a/docs/include_features.md b/docs/include_features.md
@@ -10,7 +10,7 @@ Make sure to review the documentation for each component individually as a refer
 # Display an iframe
 
 Display an iframe in your page using the
-[`amp-iframe`](../extensions/amp-iframe/amp-iframe.md) element.
+[`amp-iframe`](../extensions/amp-iframe/README.md) element.
 
 `amp-iframe` requirements:
 
@@ -100,7 +100,7 @@ amp-img {
 ## Include an animated image
 
 Include an animated image in your page
-using the [`amp-anim`](../extensions/amp-anim/amp-anim.md) element.
+using the [`amp-anim`](../extensions/amp-anim/README.md) element.
 
 The `amp-anim` element is very similar to the `amp-img` element,
 and provides additional functionality to manage loading and playing
@@ -125,7 +125,7 @@ The placeholder is specified via the `placeholder` attribute:
 ## Embed a Tweet
 
 Embed a Twitter Tweet in your page
-using the [`amp-twitter`](../extensions/amp-twitter/amp-twitter.md) element.
+using the [`amp-twitter`](../extensions/amp-twitter/README.md) element.
 
 To include a tweet in your page,
 first include the following script to the `<head>`:
@@ -194,7 +194,7 @@ if the browser doesn't support HTML5 video, for example:
 ## Include a youtube video
 
 Include a youtube video in your page
-using the [`amp-youtube`](../extensions/amp-youtube/amp-youtube.md) element.
+using the [`amp-youtube`](../extensions/amp-youtube/README.md) element.
 
 You must include the following script in the `<head>`:
 
@@ -217,7 +217,7 @@ Use `layout="responsive"` to yield correct layouts for 16:9 aspect ratio videos:
 ## Include an audio resource
 
 Include an audio resource in your page,
-using the [`amp-audio`](../extensions/amp-audio/amp-audio.md) element.
+using the [`amp-audio`](../extensions/amp-audio/README.md) element.
 
 You must include the following script in the `<head>`:
 

diff --git a/extensions/amp-access/amp-access.md → extensions/amp-access/README.md b/extensions/amp-access/amp-access.md → extensions/amp-access/README.md
diff --git a/extensions/amp-analytics/amp-analytics.md → extensions/amp-analytics/README.md b/extensions/amp-analytics/amp-analytics.md → extensions/amp-analytics/README.md
@@ -73,7 +73,7 @@ when the document is first loaded, and each time an `<a>` tag is clicked:
     ```
 
   - `data-consent-notification-id` Optional attribute. If provided will stop
-    processing the analytics request until a [amp-user-notification](../../extensions/amp-user-notification/amp-user-notification.md) with
+    processing the analytics request until a [amp-user-notification](../../extensions/amp-user-notification/README.md) with
     the given HTML-id was confirmed by the user.
 
 ## Configuration

diff --git a/extensions/amp-anim/amp-anim.md → extensions/amp-anim/README.md b/extensions/amp-anim/amp-anim.md → extensions/amp-anim/README.md
diff --git a/extensions/amp-audio/amp-audio.md → extensions/amp-audio/README.md b/extensions/amp-audio/amp-audio.md → extensions/amp-audio/README.md
diff --git a/extensions/amp-brightcove/amp-brightcove.md → extensions/amp-brightcove/README.md b/extensions/amp-brightcove/amp-brightcove.md → extensions/amp-brightcove/README.md
diff --git a/extensions/amp-carousel/amp-carousel.md → extensions/amp-carousel/README.md b/extensions/amp-carousel/amp-carousel.md → extensions/amp-carousel/README.md
diff --git a/...ic-css-classes/amp-dynamic-css-classes.md → extensions/amp-dynamic-css-classes/README.md b/...ic-css-classes/amp-dynamic-css-classes.md → extensions/amp-dynamic-css-classes/README.md
diff --git a/extensions/amp-facebook/amp-facebook.md → extensions/amp-facebook/README.md b/extensions/amp-facebook/amp-facebook.md → extensions/amp-facebook/README.md
diff --git a/extensions/amp-fit-text/amp-fit-text.md → extensions/amp-fit-text/README.md b/extensions/amp-fit-text/amp-fit-text.md → extensions/amp-fit-text/README.md
diff --git a/extensions/amp-font/amp-font.md → extensions/amp-font/README.md b/extensions/amp-font/amp-font.md → extensions/amp-font/README.md
diff --git a/extensions/amp-iframe/amp-iframe.md → extensions/amp-iframe/README.md b/extensions/amp-iframe/amp-iframe.md → extensions/amp-iframe/README.md
diff --git a/.../amp-image-lightbox/amp-image-lightbox.md → extensions/amp-image-lightbox/README.md b/.../amp-image-lightbox/amp-image-lightbox.md → extensions/amp-image-lightbox/README.md
diff --git a/extensions/amp-instagram/amp-instagram.md → extensions/amp-instagram/README.md b/extensions/amp-instagram/amp-instagram.md → extensions/amp-instagram/README.md
diff --git a/...erviceworker/amp-install-serviceworker.md → ...sions/amp-install-serviceworker/README.md b/...erviceworker/amp-install-serviceworker.md → ...sions/amp-install-serviceworker/README.md
diff --git a/extensions/amp-lightbox/amp-lightbox.md → extensions/amp-lightbox/README.md b/extensions/amp-lightbox/amp-lightbox.md → extensions/amp-lightbox/README.md
diff --git a/extensions/amp-list/amp-list.md → extensions/amp-list/README.md b/extensions/amp-list/amp-list.md → extensions/amp-list/README.md
diff --git a/extensions/amp-mustache/amp-mustache.md → extensions/amp-mustache/README.md b/extensions/amp-mustache/amp-mustache.md → extensions/amp-mustache/README.md
diff --git a/extensions/amp-pinterest/amp-pinterest.md → extensions/amp-pinterest/README.md b/extensions/amp-pinterest/amp-pinterest.md → extensions/amp-pinterest/README.md
diff --git a/extensions/amp-slides/amp-slides.md → extensions/amp-slides/README.md b/extensions/amp-slides/amp-slides.md → extensions/amp-slides/README.md
diff --git a/extensions/amp-twitter/amp-twitter.md → extensions/amp-twitter/README.md b/extensions/amp-twitter/amp-twitter.md → extensions/amp-twitter/README.md
diff --git a/...ser-notification/amp-user-notification.md → extensions/amp-user-notification/README.md b/...ser-notification/amp-user-notification.md → extensions/amp-user-notification/README.md
diff --git a/extensions/amp-vine/amp-vine.md → extensions/amp-vine/README.md b/extensions/amp-vine/amp-vine.md → extensions/amp-vine/README.md
diff --git a/extensions/amp-youtube/amp-youtube.md → extensions/amp-youtube/README.md b/extensions/amp-youtube/amp-youtube.md → extensions/amp-youtube/README.md
diff --git a/spec/amp-html-components.md b/spec/amp-html-components.md
@@ -173,17 +173,17 @@ In these cases, services may set up endpoints that produce data that conforms to
 ## Components
 
 - [amp-img](../builtins/amp-img.md)
-- [amp-audio](../extensions/amp-audio/amp-audio.md)
-- [amp-anim](../extensions/amp-anim/amp-anim.md)
+- [amp-audio](../extensions/amp-audio/README.md)
+- [amp-anim](../extensions/amp-anim/README.md)
 - [amp-ad](../builtins/amp-ad.md)
 - [amp-pixel](../builtins/amp-pixel.md)
 - [amp-video](../builtins/amp-video.md)
-- [amp-brightcove](../extensions/amp-brightcove/amp-brightcove.md)
-- [amp-carousel](../extensions/amp-carousel/amp-carousel.md)
-- [amp-font](../extensions/amp-font/amp-font.md)
-- [amp-lightbox](../extensions/amp-lightbox/amp-lightbox.md)
-- [amp-iframe](../extensions/amp-iframe/amp-iframe.md)
-- [amp-instagram](../extensions/amp-instagram/amp-instagram.md)
-- [amp-twitter](../extensions/amp-twitter/amp-twitter.md)
-- [amp-vine](../extensions/amp-vine/amp-vine.md)
-- [amp-youtube](../extensions/amp-youtube/amp-youtube.md)
+- [amp-brightcove](../extensions/amp-brightcove/README.md)
+- [amp-carousel](../extensions/amp-carousel/README.md)
+- [amp-font](../extensions/amp-font/README.md)
+- [amp-lightbox](../extensions/amp-lightbox/README.md)
+- [amp-iframe](../extensions/amp-iframe/README.md)
+- [amp-instagram](../extensions/amp-instagram/README.md)
+- [amp-twitter](../extensions/amp-twitter/README.md)
+- [amp-vine](../extensions/amp-vine/README.md)
+- [amp-youtube](../extensions/amp-youtube/README.md)
diff --git a/spec/amp-iframe-origin-policy.md b/spec/amp-iframe-origin-policy.md
@@ -1,6 +1,6 @@
 # Iframe origin policy
 
-Various AMP features allow loading iframes from arbitrary origins into AMP pages. Examples are the [`amp-iframe`](../extensions/amp-iframe/amp-iframe.md) element and [the custom domain feature of `amp-ad`](../builtins/amp-ad.md#running-ads-from-a-custom-domain). The origin of a URL such as `https://example.com/some/path` is `https://example.com`. See [the HTML5 spec](https://www.w3.org/TR/2011/WD-html5-20110525/origin-0.html#origin) for details.
+Various AMP features allow loading iframes from arbitrary origins into AMP pages. Examples are the [`amp-iframe`](../extensions/amp-iframe/README.md) element and [the custom domain feature of `amp-ad`](../builtins/amp-ad.md#running-ads-from-a-custom-domain). The origin of a URL such as `https://example.com/some/path` is `https://example.com`. See [the HTML5 spec](https://www.w3.org/TR/2011/WD-html5-20110525/origin-0.html#origin) for details.
 
 These iframes are typically allowed to execute arbitrary JavaScript, but for security reasons they are never allowed to access the AMP document itself using any method besides sending messages via postMessage.
 

diff --git a/spec/amp-var-substitutions.md b/spec/amp-var-substitutions.md
@@ -19,7 +19,7 @@ limitations under the License.
 ## Overview
 
 Some components such as [`amp-pixel`](../builtins/amp-pixel.md) and
-[`amp-list`](../extensions/amp-list/amp-list.md) allow variables to be substituted
+[`amp-list`](../extensions/amp-list/README.md) allow variables to be substituted
 in the relevant URLs. AMP provides a number of standard variable substitutions and
 allows each component to add their own. The rest of this document talks about
 the variables supported by the platform.

diff --git a/validator/testdata/feature_tests/amp_brightcove.html b/validator/testdata/feature_tests/amp_brightcove.html
@@ -16,7 +16,7 @@
 <!--
   Test Description:
   Tests support for the amp-brightcove tag.
-  https://github.com/ampproject/amphtml/blob/master/extensions/amp-brightcove/amp-brightcove.md
+  https://github.com/ampproject/amphtml/blob/master/extensions/amp-brightcove/README.md
 -->
 <!doctype html>
 <html ⚡>

diff --git a/validator/testdata/feature_tests/amp_brightcove.out b/validator/testdata/feature_tests/amp_brightcove.out
@@ -1,3 +1,3 @@
 FAIL
-feature_tests/amp_brightcove.html:46:2 The mandatory attribute 'data-account' is missing in tag 'amp-brightcove'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-brightcove/amp-brightcove.md)
-feature_tests/amp_brightcove.html:50:7 The 'amp-brightcove extension .js script' tag is missing or incorrect, but required by 'amp-brightcove'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-brightcove/amp-brightcove.md)
+feature_tests/amp_brightcove.html:46:2 The mandatory attribute 'data-account' is missing in tag 'amp-brightcove'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-brightcove/README.md)
+feature_tests/amp_brightcove.html:50:7 The 'amp-brightcove extension .js script' tag is missing or incorrect, but required by 'amp-brightcove'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-brightcove/README.md)
diff --git a/validator/testdata/feature_tests/amp_facebook.html b/validator/testdata/feature_tests/amp_facebook.html
@@ -16,7 +16,7 @@
 <!--
   Test Description:
   Tests support for the amp-facebook tag.
-  https://github.com/ampproject/amphtml/blob/master/extensions/amp-facebook/amp-facebook.md
+  https://github.com/ampproject/amphtml/blob/master/extensions/amp-facebook/README.md
 -->
 <!doctype html>
 <html ⚡>

diff --git a/validator/testdata/feature_tests/amp_font.html b/validator/testdata/feature_tests/amp_font.html
@@ -27,7 +27,7 @@
   <!--
     Test Description:
     Tests support for the amp-font tag.
-    https://github.com/ampproject/amphtml/blob/master/extensions/amp-font/amp-font.md
+    https://github.com/ampproject/amphtml/blob/master/extensions/amp-font/README.md
   -->
   <amp-font
       layout="nodisplay"

diff --git a/validator/testdata/feature_tests/amp_list.out b/validator/testdata/feature_tests/amp_list.out
@@ -1,5 +1,5 @@
 FAIL
-feature_tests/amp_list.html:36:2 The attribute 'wdith' may not appear in tag 'amp-list'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-list/amp-list.md)
-feature_tests/amp_list.html:41:2 The mandatory attribute 'src' is missing in tag 'amp-list'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-list/amp-list.md)
-feature_tests/amp_list.html:46:2 The implied layout 'CONTAINER' is not supported by tag 'amp-list'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-list/amp-list.md)
-feature_tests/amp_list.html:50:7 The 'amp-list extension .js script' tag is missing or incorrect, but required by 'amp-list'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-list/amp-list.md)
+feature_tests/amp_list.html:36:2 The attribute 'wdith' may not appear in tag 'amp-list'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-list/README.md)
+feature_tests/amp_list.html:41:2 The mandatory attribute 'src' is missing in tag 'amp-list'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-list/README.md)
+feature_tests/amp_list.html:46:2 The implied layout 'CONTAINER' is not supported by tag 'amp-list'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-list/README.md)
+feature_tests/amp_list.html:50:7 The 'amp-list extension .js script' tag is missing or incorrect, but required by 'amp-list'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-list/README.md)
diff --git a/validator/testdata/feature_tests/amp_pinterest.html b/validator/testdata/feature_tests/amp_pinterest.html
@@ -16,7 +16,7 @@
 <!--
   Test Description:
   Tests support for the amp-pinterest tag.
-  https://github.com/ampproject/amphtml/blob/master/extensions/amp-pinterest/amp-pinterest.md
+  https://github.com/ampproject/amphtml/blob/master/extensions/amp-pinterest/README.md
 -->
 <!doctype html>
 <html ⚡>

diff --git a/validator/testdata/feature_tests/amp_user_notification.out b/validator/testdata/feature_tests/amp_user_notification.out
@@ -1,7 +1,7 @@
 FAIL
-feature_tests/amp_user_notification.html:41:2 The mandatory attribute 'data-show-if-href' is missing in tag 'amp-user-notification'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-user-notification/amp-user-notification.md)
-feature_tests/amp_user_notification.html:50:2 The mandatory attribute 'data-dismiss-href' is missing in tag 'amp-user-notification'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-user-notification/amp-user-notification.md)
-feature_tests/amp_user_notification.html:59:2 The mandatory attribute 'data-show-if-href' is missing in tag 'amp-user-notification'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-user-notification/amp-user-notification.md)
-feature_tests/amp_user_notification.html:59:2 The mandatory attribute 'data-dismiss-href' is missing in tag 'amp-user-notification'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-user-notification/amp-user-notification.md)
-feature_tests/amp_user_notification.html:67:2 The specified layout 'CONTAINER' is not supported by tag 'amp-user-notification'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-user-notification/amp-user-notification.md)
-feature_tests/amp_user_notification.html:77:7 The 'amp-user-notification extension .js script' tag is missing or incorrect, but required by 'amp-user-notification'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-user-notification/amp-user-notification.md)
+feature_tests/amp_user_notification.html:41:2 The mandatory attribute 'data-show-if-href' is missing in tag 'amp-user-notification'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-user-notification/README.md)
+feature_tests/amp_user_notification.html:50:2 The mandatory attribute 'data-dismiss-href' is missing in tag 'amp-user-notification'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-user-notification/README.md)
+feature_tests/amp_user_notification.html:59:2 The mandatory attribute 'data-show-if-href' is missing in tag 'amp-user-notification'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-user-notification/README.md)
+feature_tests/amp_user_notification.html:59:2 The mandatory attribute 'data-dismiss-href' is missing in tag 'amp-user-notification'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-user-notification/README.md)
+feature_tests/amp_user_notification.html:67:2 The specified layout 'CONTAINER' is not supported by tag 'amp-user-notification'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-user-notification/README.md)
+feature_tests/amp_user_notification.html:77:7 The 'amp-user-notification extension .js script' tag is missing or incorrect, but required by 'amp-user-notification'. (see https://github.com/ampproject/amphtml/blob/master/extensions/amp-user-notification/README.md)