Skip to content

Ads: document the L-shape anchor corner (ADS-831) - #960

Draft
MaartenRimaux wants to merge 1 commit into
mainfrom
ADS-831-lshape-anchor
Draft

MaartenRimaux wants to merge 1 commit into
mainfrom
ADS-831-lshape-anchor

Conversation

@MaartenRimaux

@MaartenRimaux MaartenRimaux commented Nov 5, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Jira: ADS-831: L-shape ads with an inverted layout (content top right, ad on the left and bottom).

Documents the new anchor on lshape_ad and lshape_content variants (top_left default, top_right, bottom_left, bottom_right), per Break Manifest spec 1.11.0.

File Change
ads/concepts/breaks.mdx New "L-shape anchor" section under Layouts: the four corners, box geometry (65%, 5% inset), default top_left, 400 on an unknown value, minimum SDK version (1.5.0), JSON example. The L-shape ad section links to it.
ads/assets/img/breaks/lshape-anchors.svg New figure of the four anchor positions, in the style of the existing layout figures.

Related

  • Spec: Dolby-OptiView/optiview-ads-manifest-spec#41 (released as 1.11.0)
  • Backend (merged): Dolby-OptiView/optiview-ads#298
  • SDK: dolby-ads-sdk branch feature/ADS-831-lshape-anchor (Bitbucket)

Decision log

Decision Alternatives Rationale
One shared section for both L-shapes Repeat the anchor text in each L-shape section Same field and behaviour on both formats
API reference pages not regenerated here Run refresh-ads-api-docs in this PR The production OpenAPI does not expose anchor yet; the update-ads-api-docs workflow regenerates it once the backend is deployed
SDK minimum version stated as 1.5.0 Placeholder Latest SDK release is 1.4.0 and anchor is a minor feature; confirm before merge

Before merge

  • Ads SDK with anchor support is released, and the version in breaks.mdx (1.5.0) matches it
  • Backend deployed and the API reference regenerated with anchor (update-ads-api-docs PR)

Test plan

  • prettier --check ads/concepts/breaks.mdx
  • mdxlint ads/concepts/breaks.mdx --quiet --frail
  • Preview build renders the new figure and anchor links

Generated with Devin

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@theoplayer-bot

theoplayer-bot Bot commented Nov 5, 2026

Copy link
Copy Markdown
Contributor
Documentation preview
🚀 View preview at
https://docs-preview.optiview.dolby.com/pr-960/

Deployed from commit c12bca5 at 2026-11-05 16:35 UTC.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant