ampproject / ampproject/amp.dev

amp-story-cta-layer documentation is incomplete/out-of-date

Open
#3,440 0 comments 1 reaction 1 assignee Claimed by @CrystalOnScript View on GitHub
Category: Documentation P1: High Type: Update
Dominant language
HTML
Stars
600
Forks
675
PR merge metrics
No merged PRs in 30d

Description

## 📖 Missing or Out-of-Date Documentation

### Problem
There are a number of issues with the reference doc page of amp-story-cta-layer as of now, including, but possibly not limited to:

* Incorrectly states that this is the only way to get links in AMP Stories. Truth is: You can have links anywhere, but with the CTA layer, they get special treatment (direct link / single click/tap), whereas outside of the CTA layer, the first click produces a 'bubble', which you have to click again to open the link.
* Should make clear how links work within the CTA layer and outside of it.
* "The amp-story-cta-layer allows mostly the same descendants as amp-story-grid-layer, and additionally allows and tags." is pretty user hostile, as I have no idea what that means. Also incorrect now, as the two allow exactly the same elements now, AFAIK.

### Location
https://amp.dev/documentation/components/amp-story-cta-layer/?format=stories

### Content type
reference docs

### Information architecture (optional)
- Probably also warrants a guide in the story documentation titled "How to link to other content in AMP Stories", that at high level covers all options (normal links, and how to mark up that bubble, CTA layer links, page attachments, referral links..)

/cc @newmuis @samitron7

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.