docs(setup): stop naming a release version that goes stale - #38
Merged
Conversation
The iOS note claimed the npm/Android version was 0.1.0-field.2. It has been field.6 since #37, and the sentence would have gone stale again at the next bump. It now points at package.json and build.gradle instead of restating their contents; the 0.0.58 marketing version it contrasts with is unchanged and still accurate. Also records what versionCode actually is. The values look like epoch seconds because the first was generated that way, but field.5 and field.6 increment it by hand, so it no longer encodes a build time. Anyone deriving the next one from a clock would be guessing. Adds the missing newline at end of file while editing it. No behaviour, tooling, or version metadata changed. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
BMichaelJ
approved these changes
Sep 10, 2026
BMichaelJ
left a comment
Collaborator
There was a problem hiding this comment.
Reviewed the setup documentation against the npm, Android, and Xcode version metadata. No blocking issues found; this changes documentation only. Optional wording nit: "every new tester release" is more precise than "every build a tester installs", since same-version reinstalls are permitted.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Two documentation corrections found while reviewing #37. Documentation only, no
behaviour, tooling, or version metadata changed.
0.1.0-field.2. It has been0.1.0-field.6since chore: prepare field.6 review candidate #37 merged, and thesentence would have gone stale again at the next bump. It now points at
package.jsonandandroid/app/build.gradlerather than restating theircontents. The
0.0.58marketing version it contrasts with is unchanged andstill accurate, so the point it was making survives.
versionCodeactually is. The values look like epoch secondsbecause the first was generated that way, but field.5 and field.6 increment
it by hand, so it no longer encodes a build time. Anyone deriving the next
one from a clock would be guessing, and a value that lands below the
installed build blocks the in-place upgrade testers rely on.
Also adds the missing newline at end of file, since the file was already open.
Type of Change
Screenshots / Screen Recordings
Not applicable. No UI change.
Checklist
General
Testing
npm test)No code changed, so none of the above apply and no test can cover a prose
correction. The claims were verified against the tree rather than tested:
0.1.0-field.6package.json0.1.0-field.6, code1787551547android/app/build.gradle0.0.58project.pbxproj, single unique value1787551545decodes to 2026-08-24T06:05:45ZA repository-wide grep found no other stale version reference in
docs/or theREADME.
React Native Specific
project.pbxproj) (not applicable)useThemedStylespattern (not applicable)FlatList/FlashList(not applicable)Performance & Models
Security
Related Issues
Found while reviewing #37. Not a blocker for it, which is why it is separate.
Additional Notes
Deliberately left alone: the iOS marketing version does not track the npm and
Android version at all, so
0.1.0-field.6describes the Android build only.The existing text already says iOS release metadata needs separate review, and
deciding whether to align the two is a release call rather than a doc fix.
The
versionCodeparagraph describes the convention as it stands. If theintent is to generate it from a clock again, the fix belongs in the release
tooling and this paragraph should change with it.