Skip to content

docs: close Android guides accuracy and reader-experience gaps (NT-3944) - #437

Draft
Felipe Mamud (fmamud) wants to merge 1 commit into
mainfrom
docs/nt-3944-android-guides-review
Draft

docs: close Android guides accuracy and reader-experience gaps (NT-3944)#437
Felipe Mamud (fmamud) wants to merge 1 commit into
mainfrom
docs/nt-3944-android-guides-review

Conversation

@fmamud

@fmamud Felipe Mamud (fmamud) commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Newcomer + technical-foundation review of both Android integration guides (integrating-the-optimization-android-sdk-in-a-compose-app.md, ...-views-app.md) per NT-3944, a sub-task of NT-3896 (Mobile SDK doc accuracy pass ahead of GA).
  • No interface or SDK behavior claims were contradicted by source, but one behavioral claim had no backing knowledge-base fact and both guides had real reader-experience defects, including one genuinely broken quick-start step in the Views guide (missing TextView layout instruction).
  • Corrected documentation/internal/sdk-knowledge/native/android.md: the missing-metadata → silent-baseline-fallback behavior is driven by the shared JS-core isResolvedContentfulEntry type guard, not a Kotlin CTEntry.from parse failure as previously implied.
  • Funneled three durable rules into skills/optimization-guide-authoring/references/authoring-checklist.md: silent-degradation behaviors must be a callout, multi-axis boolean/enum semantics must be tabulated, and code-block warnings must precede (not follow) their block.
  • Cross-checked both guides against the iOS SwiftUI guide for family consistency; removed a one-off "How to read these examples" label-taxonomy explainer that the Compose guide-writer pass had added, since no other guide in the family (iOS included) carries it and the skill already states the convention once at the skill level.

Test plan

  • pnpm knowledge:check — source pointers resolve, no ESCALATE markers
  • pnpm guides:check — guide structure/links valid
  • pnpm exec prettier --check on all touched files
  • Standard guide review process (this PR is the artifact of that review; awaiting maintainer read)

🤖 Generated with Claude Code

…(NT-3944)

Newcomer + technical-foundation review of the Compose and Views Android
integration guides for NT-3896: fixes a broken quick start (missing
TextView instruction), misleading/duplicate code labels, buried silent-
fallback and compliance-relevant traps now called out, multi-axis
consent/tap semantics tabulated, and a corrected KB fact for the
missing-metadata baseline-fallback mechanism.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
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