ampproject / ampproject/amphtml

Restructure documentation for components by 3p providers

Open
#34,224 11 comments 0 reactions 0 assignees View on GitHub
Related to: Documentation Stale Type: Discussion/Question WG: components
Dominant language
JavaScript
Stars
14.9k
Forks
4.1k
PR merge metrics
No merged PRs in 30d

Description

![image](https://user-images.githubusercontent.com/69035383/117103346-7bd36900-ad7a-11eb-952a-6aa289388ee0.png)

All these extensions in amp don't work the amp.dev examples

![image](https://user-images.githubusercontent.com/69035383/117103428-a32a3600-ad7a-11eb-98a9-4ce68362b1ac.png)

The media category is full of external providers, which for me the only thing that has given me is confusion in the amp system, I know that amp is free but when you have to learn something new, you first have to focus on the core.

I propose the separation of external providers, of the amp core, in all kinds of extensions.
It would be something like that other similar systems are already doing.
AMP CORE
amp extensions
amp experimental extensions
amp extensions external providers

I have also seen that external providers have given me errors in javascript, when loading the page.

External providers to which access to their prices or their sales web pages has cost me a lot to find them in the google search.

Honestly, after having tried all the external providers, they have not transmitted confidence to me except the official ones like dailymotion, yotube, viqueo.

But as I said, it is important to start differentiating the core from the providers so as not to waste time for developers who want to implement only AMP.

apester example no run
![image](https://user-images.githubusercontent.com/69035383/117103983-a671f180-ad7b-11eb-8aea-6fa31305b1dd.png)

errors and 404
![image](https://user-images.githubusercontent.com/69035383/117104127-e33de880-ad7b-11eb-81fb-dce99717cef2.png)

more errors
![image](https://user-images.githubusercontent.com/69035383/117104255-1c765880-ad7c-11eb-9354-9ffa5991e0de.png)

more errors
![image](https://user-images.githubusercontent.com/69035383/117104311-33b54600-ad7c-11eb-822f-169b778682df.png)

more errors
![image](https://user-images.githubusercontent.com/69035383/117104359-46c81600-ad7c-11eb-8e19-cab254ae7ec3.png)

Many xhr requests
![image](https://user-images.githubusercontent.com/69035383/117104423-63644e00-ad7c-11eb-91dd-e997c177ef83.png)

First extension that has no errors
![image](https://user-images.githubusercontent.com/69035383/117104531-960e4680-ad7c-11eb-80e5-e2c952f3df7a.png)

It seems to me a good implementation by redbull that although the requested resource is not error-free
![image](https://user-images.githubusercontent.com/69035383/117104639-cbb32f80-ad7c-11eb-9209-a152cad3e1d6.png)

A correct implementation of vimeo, without any errors
![image](https://user-images.githubusercontent.com/69035383/117104707-edacb200-ad7c-11eb-82d6-b28f175fa301.png)

more error
![image](https://user-images.githubusercontent.com/69035383/117104785-0ae18080-ad7d-11eb-9a95-e461e3d52d80.png)

error and 404
![image](https://user-images.githubusercontent.com/69035383/117104850-23ea3180-ad7d-11eb-86b5-f61ba873a7f8.png)

more error
![image](https://user-images.githubusercontent.com/69035383/117105047-85120500-ad7d-11eb-9302-478ade20e241.png)

I sincerely love that the amp is free and that anyone can develop an amp block, but you also have to be very clear about what the core is and what parts are in the extensions or everything can turn into chaos in the long run.

Contributor guide

Open the contributing guide

Research direction

Start by reviewing the AMP documentation's media category and the provider extension examples referenced in the issue, including Apester, Dailymotion, YouTube, Vimeo, and Red Bull. Done would require a documented, agreed separation between AMP core, extensions, experimental extensions, and external-provider extensions, with the reported example errors addressed or clearly scoped.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.