Skip to main content

​
Task Journal — WP-3.4 docs fact-check round 1 (pipeline P6)

​
Task

  • linear-id: none
  • track: docs-improvement WP-3.4 (../docs-improvement/PLAN.md §5.4 P6, §5.2 map)
  • title: First fact-check pass over top funnel pages (Tier A, 16 pages)
  • worktree: documentation_mintlify.worktrees/docs-factcheck (branch docs/fact-check-r1)
  • skill: .claude/skills/docs-fact-check/SKILL.md

​
Goal

For each of 16 Tier-A pages: extract checkable claims (SDK signatures/method names, version tables, API fields, limits, UI steps, stated negatives) → verify against the source-of-truth map (gh for SDK repos, local repos for backends/spec, rest-api-v4.yaml for API) → verdict confirmed/drift/unverifiable → record in verification.json. Only verification.json + this journal may be edited; content .mdx are owned by parallel agents — drifts go to the report only.

​
Scope (16)

quickstart, install-sdk, ios-sdk-setup, android-sdk, react-native-sdk, flutter-sdk, entitlements, create-products, user-properties, user-identifiers, testing, handling-errors, rate-limits, reference/v4/overview, reference/v4/authentication, snippets/code/init-sdk.

​
Roadmap

  • Read all 16 pages
  • SDK version checks (releases): android 8.+ (DRIFT->9), flutter ^11 ok, RN pkg ok, ios ok
  • init-sdk snippet: init method + LaunchMode enum all 8 platforms — CONFIRMED
  • user-properties / user-identifiers / testing: method signatures + enums — CONFIRMED
  • handling-errors: error-code enum table vs QONErrors.h — CONFIRMED (all Int values)
  • rate-limits: 5 req/s vs android NetworkModule (=5) — CONFIRMED; version table unverifiable
  • create-products: Android 9+/Billing 8 basePlanId CONFIRMED; Stripe/Paddle prefixes unverifiable (3rd-party)
  • reference v4 overview + authentication vs rest-api-v4.yaml + api-gateway — CONFIRMED
  • Write verification.json (16 entries)
  • Commit verification.json + journal

​
Decisions

  • SDK repos not checked out locally → verify via gh (search code / release list).
  • Backends, mcp-server, spec are local under /Users/smejl/Desktop/github.com/qonversion/.
  • Version-table check first (cheapest, highest value per skill).

​
Findings

Drifts (report only — parallel agents own the .mdx):
  • android-sdk.mdx (MEDIUM): install snippet io.qonversion.android.sdk:sdk:8.+ but latest Android major is 9 (release sdk/9.6.0, 2026-07-21). Should be 9.+. Contradicts create-products.mdx (“Android SDK 9+ / Billing Library 8”).
  • user-properties.mdx (LOW): defined-property table omits SDK enum member TenjinAnalyticsInstallationId('_q_tenjin_aiid'); display name AppMetricalProfileId is a typo vs SDK AppMetricaUserProfileId (key matches).
Unverifiable (surface to user, do not delete):
  • rate-limits.mdx per-platform “rate limit added in version” table (iOS 5.1.1, Android 6.1.1, RN 6.1.0, Flutter 7.1.0, Unity 6.1.0, Cordova 4.1.0, Cap 0.1.0) — historical intro versions, not walked per-repo this pass.
  • create-products.mdx Stripe prod_ / Paddle pro_ ID prefixes — third-party formats, outside our repos (correct per Stripe/Paddle conventions).
  • testing.mdx Apple/Google sandbox renewal-rate table — third-party console behaviour; Tier-A cadence is the only guard.
  • entitlements/create-products/testing dashboard UI steps — not walked in dash-mono this pass (low risk).
Everything else CONFIRMED against source (see verification.json).

​
Dead Ends

  • gh search code hit the 403 secondary rate limit mid-pass; switched to gh api .../contents ... -H "Accept: application/vnd.github.raw+json" (separate budget) to read whole SDK files. No pipes allowed → base64 decode via jq blocked; raw accept header avoids it.

​
Next Action

Fact-check follow-up fixes shipped on docs/factcheck-fixes (2026-07-25): android-sdk gradle pin 8.+ -> 9.+ (latest major 9.6.0), user-properties table (AppMetricaUserProfileId typo fixed + TenjinAnalyticsInstallationId row added), macos-catalyst wired to the NextStepsChooseMode snippet (the 8th SDK-setup page, missed by WP-3.1 ownership). Remaining: WP-3.2 screenshots (in flight).