Skip to content

docs: centralize guides under docs/ for docs.rdlabo.dev - #453

Merged
rdlabo merged 16 commits into
mainfrom
agent/docs-centralize
Aug 19, 2026
Merged

docs: centralize guides under docs/ for docs.rdlabo.dev#453
rdlabo merged 16 commits into
mainfrom
agent/docs-centralize

Conversation

@rdlabo

@rdlabo rdlabo commented Aug 19, 2026

Copy link
Copy Markdown
Member

Summary

  • Split long-form AdMob guides into docs/ (configuration, consent, banner, interstitial, rewarded, app-open, events, testing, migration).
  • Restructure README with Overview, Features, Quick start, Installation, and Documentation links.
  • Wrap GitHub-only sections (badges, screenshots, docgen Index/API, License) in <!-- rdlabo-docs-omit --> markers so docs.rdlabo.dev can import the README and guides without duplicating content.

Companion portal PR: rdlabo-dev/website#5

Test plan

  • README renders correctly on GitHub (omit markers are HTML comments)
  • Relative links from README to docs/*.md resolve on GitHub
  • Docgen blocks remain in README for npm/GitHub API consumers

rdlabo added 16 commits August 18, 2026 17:41
Split the long README tutorial into focused docs pages and slim the README to overview, quick start, and API reference links.
Align GitHub docs with the rdlabo-docs page map so they can be
imported as source material: Capacitor 8 install, shared event/revenue
tables, and option coverage without duplicating UMP testing notes.
Keep the consent sample aligned with Google's IDFA flow, point API
links at a single README heading, and drop maintainer-only wording
so a Capacitor app developer can follow install through first ad.
Hand-written Options tables drifted from docgen. Point the guides at README anchors instead of duplicating interface fields.
Add a short official definition and Android/iOS links at the top of every guide so readers can learn the format from Google first.
Google's setup guides tell you to add Mobile Ads yourself. Spell out that this plugin already ships the SDK, and send npm README readers to the docs site.
SizeChanged height has to shrink ion-router-outlet (and modals/tab bars). The native overlay does not move ion-content on its own.
Overwriting ion-router-outlet bottom and padding ion-tab-bar with the same height breaks standard ion-tabs. Move the whole ion-app instead.
The Ionic layout example now matches BannerViewportService in demo/angular.
Keep the layout guidance framework-agnostic so it does not invent an Ionic recipe.
Keep the generated Index/API block as on main, and start the guide files at the heading so GitHub does not render YAML fences.
Native setup is not an API method, so AndroidManifest, Info.plist, and SDK pins stay in the README instead of a separate guide.
Plugin users were scrolling past AndroidManifest and SKAdNetwork before seeing how to show an ad. Expand first-use terms and point format guides at initialize and consent.
Hide badges, docgen Index/API, and License from docs.rdlabo.dev while
keeping them visible on GitHub.
@rdlabo
rdlabo force-pushed the agent/docs-centralize branch from 69e36f8 to 8a03365 Compare August 19, 2026 03:55
@rdlabo
rdlabo merged commit cd5740c into main Aug 19, 2026
6 checks passed
@rdlabo
rdlabo deleted the agent/docs-centralize branch August 19, 2026 03:59
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