docs: policy-safe README intro + Before-you-ship section - #23
Conversation
Rewrite the intro to describe outcomes instead of implying store-review bypass, add a Before-you-ship section pointing developers to the relevant Play/App Store policies, clarify iOS live patching applies to bytecode data modules, and document the disableOnPlayStoreInstalls config option.
🔴 CriticalNone 🟠 MediumNone 🟡 LowNone 🟢 PositivesResponsible messaging rewrite: The intro paragraph shift from "push updates...without going through the app store review process" to "ship Dart fixes...with signed patches and automatic crash recovery" is significantly more accurate and responsible. It frames code push as a capability (rapid hotfixes) rather than implying a store-review bypass. Strong compliance guidance: The new "Before you ship" section is well-designed:
Technical accuracy: All descriptions align with the implementation:
Implementation consistency: Verified that the code path (lines 286–315 in code_push.dart) correctly implements the described behavior: early return to skip the entire update flow, patch removal, and telemetry reporting when |
Summary
disableOnPlayStoreInstallsin the section and in theCodePushConfigparameter table.README ships with the next release; no publish in this PR.