You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* Bump version number
* Update draft release notes for 26.2
* Update draft release notes for 26.2
* Release Notes: add new section for next version (26.3)
* Update release notes for 26.2
* Update strings for localization
* Update metadata strings
* Update metadata strings
---------
Co-authored-by: Oguz Kocer <oguz.kocer@automattic.com>
Copy file name to clipboardExpand all lines: CLAUDE.md
+70Lines changed: 70 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -51,3 +51,73 @@ WordPress-iOS uses a modular architecture with the main app and separate Swift p
51
51
- Branch from `trunk` (main branch)
52
52
- PR target should be `trunk`
53
53
- When writing commit messages, never include references to Claude
54
+
55
+
## Release Notes Compilation Process
56
+
57
+
### Overview
58
+
Process for compiling release notes for new iOS versions, maintaining the established tone without App Store character limits.
59
+
60
+
### Step-by-Step Process
61
+
62
+
#### 1. Study Previous Release Notes Style
63
+
Use `gh` to fetch releases and analyze professional editorialization patterns:
64
+
-**Version 25.9**: Raw added in commits `ce08612ecc324e981ef9c5898c98bb267cf29721` & `30cd7073802feb8711b2aae8bb69f41fedba1d80`, editorialized in `bc3af0d2c0c8c3dec8556bb4eff7709f3c151c0d`
65
+
-**Version 26.0**: Raw added in commits `8a9e79587924f85e6ac6756fe47d045f7db04ece` & `883acc3324abe45d0e121f3854dc84712b22b4cb`, editorialized in `2ef13c2898c5b58d09c8a3af9f109a47f0bd782c`
- Get commit hash for last release: `gh release view <last_version> --json tagName,targetCommitish`
77
+
- Confirm current branch is properly ahead of last release tag
78
+
79
+
#### 3. Identify Changes Since Last Release
80
+
Compare current release branch against last release hash using GitHub API (since local commits may not exist due to squashing/rebasing):
81
+
```bash
82
+
gh api repos/wordpress-mobile/WordPress-iOS/compare/<last_release_hash>...HEAD --jq '.commits[] | "\(.sha[0:7]) \(.commit.message | split("\n")[0])"'
83
+
```
84
+
Focus on user-facing changes from squash commit messages. **Important**: When commit messages are unclear or technical, always investigate further:
85
+
- Use `gh pr view <PR_number>` to read PR titles and descriptions
86
+
- Look for keywords indicating user-facing changes: "feat:", new functionality, UI changes, user experience
87
+
- Be especially careful with feature rollouts that may have technical-sounding commit messages but represent new user functionality
88
+
- When in doubt, investigate the PR rather than excluding potentially important features
89
+
90
+
#### 4. Compile Raw Release Notes
91
+
Create factual summary including:
92
+
-**Always check RELEASE-NOTES.txt file** (note: hyphen, not underscore) for developer-authored release notes under the version number section. These notes start with `[*]`, `[**]`, or `[***]` (stars indicate importance) and **must be included** in the raw release notes
93
+
- Only user-facing changes (exclude CI, refactoring, technical debt)
94
+
- Prioritize: New features → Improvements → Performance enhancements
95
+
- Use positive language (avoid "bug fix", prefer "improved", "enhanced", "resolved")
96
+
- Mark changes as WordPress-specific, Jetpack-specific, or both
97
+
98
+
#### 5. User Confirmation
99
+
Present raw notes to user for:
100
+
- Accuracy verification
101
+
- WordPress vs Jetpack feature classification
102
+
- Any missing or incorrect changes
103
+
- Approval to proceed with editorialization
104
+
105
+
#### 6. Editorialization
106
+
Transform raw notes using established playful style:
107
+
- Use engaging, user-friendly language
108
+
- Reference previous release note styles from step 1
109
+
- Create separate versions for WordPress and Jetpack apps
110
+
- Focus on user benefits and experience improvements
111
+
112
+
#### 7. Update Release Notes Files
113
+
Once user confirms the editorialized release notes, **replace** the contents of the following files (discard any existing content):
"We rebuilt Stats from the ground up, and it's absolutely stunning. This new experience features buttery-smooth 120fps animations, interactive charts you can tap and explore, hourly data views, and a completely customizable dashboard. You can rearrange everything, export your data, and even see your post analytics with email campaign metrics. It feels incredible to use—we keep opening it just to watch those beautiful animations. (Look for "Try New Stats" when you open Stats, or enable it anytime in Me > App Settings > Experimental Features.)\n"
87
-
"\n"
88
-
"We also made improvements to how you manage your content. You'll find a completely redesigned Post Settings screen that makes configuring your posts smoother and more intuitive, plus better VideoPress integration and improved authentication for private sites in our experimental editor.\n"
89
-
"\n"
90
-
"Finally, we squashed several bugs and made things more reliable.\n"
91
-
"- The app won't hang anymore when you open your Posts or Pages. (We know how frustrating that was.)\n"
92
-
"- We fixed a crash that happened when saving certain editor settings.\n"
93
-
"- Those annoying error popups on your dashboard? Gone.\n"
94
-
"- Application passwords now work more smoothly behind the scenes, and the Jetpack connection flow is more reliable.\n"
86
+
"- Those gorgeous Stats charts just got even better—tap any bar for instant insights, explore weekly trends, and enjoy flawless dark mode. Your data deserves this level of elegance.\n"
87
+
"- We've added mentions to the experimental editor—tag your collaborators and watch the magic happen.\n"
88
+
"- iPad Split View now behaves beautifully in portrait mode. No more awkward layouts.\n"
95
89
msgstr""
96
90
97
91
#. translators: This is a promo message that will be attached on top of the first screenshot in the App Store.
We rebuilt Stats from the ground up, and it's absolutely stunning. This new experience features buttery-smooth 120fps animations, interactive charts you can tap and explore, hourly data views, and a completely customizable dashboard. You can rearrange everything, export your data, and even see your post analytics with email campaign metrics. It feels incredible to use—we keep opening it just to watch those beautiful animations. (Look for "Try New Stats" when you open Stats, or enable it anytime in Me > App Settings > Experimental Features.)
2
-
3
-
We also made improvements to how you manage your content. You'll find a completely redesigned Post Settings screen that makes configuring your posts smoother and more intuitive, plus better VideoPress integration and improved authentication for private sites in our experimental editor.
4
-
5
-
Finally, we squashed several bugs and made things more reliable.
6
-
- The app won't hang anymore when you open your Posts or Pages. (We know how frustrating that was.)
7
-
- We fixed a crash that happened when saving certain editor settings.
8
-
- Those annoying error popups on your dashboard? Gone.
9
-
- Application passwords now work more smoothly behind the scenes, and the Jetpack connection flow is more reliable.
1
+
- Those gorgeous Stats charts just got even better—tap any bar for instant insights, explore weekly trends, and enjoy flawless dark mode. Your data deserves this level of elegance.
2
+
- We've added mentions to the experimental editor—tag your collaborators and watch the magic happen.
3
+
- iPad Split View now behaves beautifully in portrait mode. No more awkward layouts.
"We made improvements to how you manage your content and work with media. You'll find a completely redesigned Post Settings screen that makes configuring your posts smoother and more intuitive.\n"
51
-
"\n"
52
-
"We also enhanced our experimental editor with better VideoPress integration and improved authentication for private sites. Your media will display properly now, no matter your site's privacy settings.\n"
53
-
"\n"
54
-
"Finally, we squashed several bugs and made things more reliable.\n"
55
-
"- The app won't hang anymore when you open your Posts or Pages. (We know how frustrating that was.)\n"
56
-
"- We fixed a crash that happened when saving certain editor settings.\n"
57
-
"- Those annoying error popups on your dashboard? Gone.\n"
58
-
"- Application passwords now work more smoothly behind the scenes.\n"
50
+
"- We've added mentions to the experimental editor—tag your collaborators and watch the magic happen.\n"
51
+
"- iPad Split View now behaves beautifully in portrait mode. No more awkward layouts.\n"
59
52
msgstr""
60
53
61
54
#. translators: This is a standard chunk of text used to tell a user what's new with a release when nothing major has changed.
We made improvements to how you manage your content and work with media. You'll find a completely redesigned Post Settings screen that makes configuring your posts smoother and more intuitive.
2
-
3
-
We also enhanced our experimental editor with better VideoPress integration and improved authentication for private sites. Your media will display properly now, no matter your site's privacy settings.
4
-
5
-
Finally, we squashed several bugs and made things more reliable.
6
-
- The app won't hang anymore when you open your Posts or Pages. (We know how frustrating that was.)
7
-
- We fixed a crash that happened when saving certain editor settings.
8
-
- Those annoying error popups on your dashboard? Gone.
9
-
- Application passwords now work more smoothly behind the scenes.
1
+
- We've added mentions to the experimental editor—tag your collaborators and watch the magic happen.
2
+
- iPad Split View now behaves beautifully in portrait mode. No more awkward layouts.
0 commit comments