Skip to main content

​
Task Journal

​
Task

​
Goal

Remove Offerings from the documentation entirely (phase 1 of the Offerings sunset): no offerings pages or promos anywhere; the only remaining mention is the migration guide that old links redirect to. Context: workspace research in ../offerings-removal/RESEARCH.md (usage data, quarantine strategy); companion dash change qonversion/dash-mono#571 (Offerings tab hidden for projects without offerings).

​
Roadmap

  • Migration guide docs/migrate-offerings-to-remote-configs.mdx (mapping, payload convention, code samples, dark-theme screenshot)
  • Delete docs/offerings.mdx + 301 /docs/offerings → migration guide
  • Strip offerings from displaying-products, subscription-management-mode, cache/reliability pages, non-subscription-purchases, reference/products
  • RevenueCat / Adapty / Glassfy guides: map competitor Offerings/Paywalls → Remote Configs, replace Qonversion offerings() samples with remoteConfig()+products()
  • Navigation: drop the Offerings entry from the Remote Config group
  • Reusable screenshot tooling scripts/dash-screenshots/ + .claude/skills/docs-dash-screenshots
  • Triple review (coherence + images + dash onboarding): fixed pre-existing broken anchor remote-config#2-segment-users→#5, re-shot 3dd5f7f (old sidebar showed an Offerings tab) as remote-config-create-configuration.png
  • PR #100 review & merge

​
Decisions

  • Full removal, not “legacy” labels: offerings must not be presented anywhere; the migration guide is the single allowed mention (2026-07-18).
  • reference/v4/offerings + OpenAPI spec kept — the public API sunset is a separate phase (mirrors the Screens removal precedent).
  • Historical SDK migration guides and the error-code table keep factual offerings mentions.
  • Docs screenshots: local Sample Application project only (no customer names), dark theme — enforced by the tooling.

​
Dead Ends

  • npx mint broken-links crashes on this repo (Maximum call stack size exceeded) — links verified manually.

​
Next Action

Get PR #100 reviewed; after merge, follow up with SDK doc-comment links (qonversion.io/docs/offerings in SDK sources is already 404) during the SDK deprecation pass.

​
Follow-ups

  • Website repo: forward qonversion.io/docs/:path* → documentation.qonversion.io/docs/:path* (fixes ALL SDK @see links without touching SDK releases; redirects for the legacy slugs product-center/observer-mode added here on 2026-07-18).
  • SDK repos: @Deprecated on offerings() + refresh @see links — no longer urgent once the website forward ships.
  • Website blog posts link documentation.qonversion.io/docs/offerings (2 posts, EN+DE) — covered by the 301, optionally update.
  • Refresh old-design screenshots on remote-config.mdx with the new tooling.