Skip to content

Commit eab3817

Browse files
Merge release/26.2 into trunk (#22182)
* Bump version number * Update draft release notes for 26.2 * Update draft release notes for Jetpack 26.2. * Release Notes: add new section for next version (26.3) * Update release notes for 26.2 * Freeze strings for translation * Minor updates to 26.2 release notes * Update WordPress `PlayStoreStrings.po` for version 26.2 * Update Jetpack `PlayStoreStrings.po` for version 26.2 --------- Co-authored-by: Oguz Kocer <[email protected]>
1 parent e8945f4 commit eab3817

File tree

8 files changed

+114
-33
lines changed

8 files changed

+114
-33
lines changed

CLAUDE.md

Lines changed: 73 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
66

77
### Main Build Commands
88
- `./gradlew assembleWordPressVanillaDebug` - Build debug APK for WordPress app
9-
- `./gradlew assembleJetpackVanillaDebug` - Build debug APK for Jetpack app
9+
- `./gradlew assembleJetpackVanillaDebug` - Build debug APK for Jetpack app
1010
- `./gradlew installWordPressVanillaDebug` - Install debug APK to connected device
1111
- `./gradlew installJetpackVanillaDebug` - Install debug APK for Jetpack to device
1212

@@ -38,7 +38,7 @@ This repository builds two apps from shared codebase:
3838
├── WordPress/ # Main app module
3939
├── libs/
4040
│ ├── fluxc/ # Networking and data layer (FluxC architecture)
41-
│ ├── login/ # Shared login functionality
41+
│ ├── login/ # Shared login functionality
4242
│ ├── editor/ # Block editor integration
4343
│ ├── image-editor/ # Image editing functionality
4444
│ ├── analytics/ # Analytics and tracking
@@ -61,7 +61,7 @@ WordPress/src/main/java/org/wordpress/android/
6161
├── ui/ # UI layer organized by feature
6262
│ ├── posts/ # Post creation and management
6363
│ ├── reader/ # Content discovery and reading
64-
│ ├── stats/ # Site analytics and statistics
64+
│ ├── stats/ # Site analytics and statistics
6565
│ ├── bloggingreminders/ # Posting reminders system
6666
│ ├── comments/ # Comment management
6767
│ ├── accounts/ # Authentication and signup
@@ -85,7 +85,7 @@ WordPress/src/main/java/org/wordpress/android/
8585
### Code Quality Tools
8686
- Android Code Style Guidelines with project-specific Checkstyle and Detekt rules
8787
- **Checkstyle**: Java code style enforcement (`config/checkstyle.xml`)
88-
- **Detekt**: Kotlin code analysis (`config/detekt/detekt.yml`)
88+
- **Detekt**: Kotlin code analysis (`config/detekt/detekt.yml`)
8989
- **Android Lint**: Built-in Android static analysis
9090
- **Line Length**: 120 characters max
9191
- **No FIXME**: Use TODO instead of FIXME in committed code
@@ -97,4 +97,72 @@ WordPress/src/main/java/org/wordpress/android/
9797
- Remote build cache available for faster builds (requires setup)
9898
- Fastlane used for release automation and testing
9999
- Secrets managed via `secrets.properties` file (not in repo)
100-
- Pre-commit hooks may modify files during commit
100+
- Pre-commit hooks may modify files during commit
101+
102+
## Release Notes Compilation Process
103+
104+
### Overview
105+
Process for compiling release notes for new versions, ensuring they meet Play Store character limits (under 500, preferably 350-400) and maintain the established playful tone.
106+
107+
### Step-by-Step Process
108+
109+
#### 1. Study Previous Release Notes Style
110+
Use `gh` to fetch releases and analyze professional editorialization patterns:
111+
- **Version 25.8**: Raw added in commits `8cd1b4cc268887b9e2de94fb19afc108b011f0da` & `93591923dd9a9c144729952ad0dfbc9306f69894`, editorialized in `8a7fc316cf0acfc2b88b1090e3ca148f2145fa92`
112+
- **Version 25.9**: Raw added in `b4a292cc9c9a30823bfdf8e770479a68362ed500`, editorialized in `dad8fa582856758999c43384ccbe55f34b6d2e17`
113+
- **Version 26.0**: Raw added in `a53234ea6b13adf18acac262ad985f94308191c6` & `63067fb7249cc860d44547bb0d1b8dee975dbe8e`, editorialized in `02854d67c42146e611f0f0dff9feb0fd48dc7fd8`
114+
115+
Commands: `gh release view 25.8`, `gh release view 25.9`, `gh release view 26.0` (note: no 'v' prefix)
116+
117+
#### 2. Verify Release Branch and Get Last Release Hash
118+
- Verify current branch follows naming: `release/x.y` (where x.y = last_release + 0.1)
119+
- Get commit hash for last release: `gh release view <last_version> --json tagName,targetCommitish`
120+
- Confirm current branch is properly ahead of last release tag
121+
122+
#### 3. Identify Changes Since Last Release
123+
Compare current release branch against last release hash:
124+
```bash
125+
git log <last_release_hash>..HEAD --oneline --no-merges
126+
```
127+
Focus on user-facing changes from squash commit messages. **Important**: When commit messages are unclear or technical, always investigate further:
128+
- Use `gh pr view <PR_number>` to read PR titles and descriptions
129+
- Look for keywords indicating user-facing changes: "feat:", new functionality, UI changes, user experience
130+
- Be especially careful with feature rollouts that may have technical-sounding commit messages but represent new user functionality
131+
- When in doubt, investigate the PR rather than excluding potentially important features
132+
133+
#### 4. Compile Raw Release Notes
134+
Create factual summary including:
135+
- **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
136+
- Only user-facing changes (exclude CI, refactoring, technical debt)
137+
- Prioritize: New features → Improvements → Performance enhancements
138+
- Use positive language (avoid "bug fix", prefer "improved", "enhanced", "resolved")
139+
- Include rough character counts to gauge condensation needed
140+
- Mark changes as WordPress-specific, Jetpack-specific, or both
141+
142+
#### 5. User Confirmation
143+
Present raw notes to user for:
144+
- Accuracy verification
145+
- WordPress vs Jetpack feature classification
146+
- Any missing or incorrect changes
147+
- Approval to proceed with editorialization
148+
149+
#### 6. Editorialization
150+
Transform raw notes using established playful style:
151+
- Keep under 350 characters (accounting for translation expansion)
152+
- Use engaging, user-friendly language
153+
- Reference previous release note styles from step 1
154+
- Create separate versions for WordPress and Jetpack apps
155+
- Focus on user benefits and experience improvements
156+
157+
#### 7. Update Release Notes Files
158+
Once user confirms the editorialized release notes, **replace** the contents of the following files (discard any existing content):
159+
- **WordPress release notes**: `WordPress/metadata/release_notes.txt`
160+
- **Jetpack release notes**: `WordPress/jetpack_metadata/release_notes.txt`
161+
162+
Document any process refinements discovered during execution.
163+
164+
### Content Guidelines
165+
- **Include**: New features, UI improvements, performance enhancements, user experience changes
166+
- **Exclude**: CI changes, code refactoring, dependency updates, internal technical changes
167+
- **Language**: Positive sentiment, avoid "fix" terminology, focus on improvements and enhancements
168+
- **Priority Order**: New features → Improvements → Performance → Other user-facing changes

RELEASE-NOTES.txt

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
*** PLEASE FOLLOW THIS FORMAT: [<priority indicator, more stars = higher priority>] <description> [<PR URL>]
22

3+
26.3
4+
-----
5+
6+
37
26.2
48
-----
59

WordPress/jetpack_metadata/PlayStoreStrings.po

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,14 @@ msgstr ""
1010
"X-Generator: VsCode\n"
1111
"Project-Id-Version: Jetpack - Apps - Android - Release Notes\n"
1212

13+
msgctxt "release_note_262"
14+
msgid ""
15+
"26.2:\n"
16+
"- Connect your self-hosted sites to Jetpack with our new streamlined flow—available right from Stats and Notifications.\n"
17+
"- We've added support for mentions in the experimental editor—tag your friends and collaborators with ease.\n"
18+
"- Media selection just got more accessible for everyone.\n"
19+
msgstr ""
20+
1321
msgctxt "release_note_261"
1422
msgid ""
1523
"26.1:\n"
@@ -19,12 +27,6 @@ msgid ""
1927
"- Fixed various upload bugs and improved overall media handling.\n"
2028
msgstr ""
2129

22-
msgctxt "release_note_260"
23-
msgid ""
24-
"26.0:\n"
25-
"We’ve added Application Passwords authentication. It’s still experimental, but once it’s fully integrated, we’ll be able to improve existing features and introduce new ones. Rock on.\n"
26-
msgstr ""
27-
2830
#. translators: Release notes for this version to be displayed in the Play Store. Limit to 500 characters including spaces and commas!
2931
#. translators: Title to be displayed in the Play Store. Limit to 30 characters including spaces and commas!
3032
msgctxt "play_store_app_title"
Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,3 @@
1-
- New Subscribers screen shows all your email and Reader subscribers—now you know who's reading your content.
2-
- Media now displays properly on private sites in the experimental editor.
3-
- Enhanced media uploads with better authentication and improved performance.
4-
- Fixed various upload bugs and improved overall media handling.
1+
- Connect your self-hosted sites to Jetpack with our new streamlined flow—available right from Stats and Notifications.
2+
- We've added support for mentions in the experimental editor—tag your friends and collaborators with ease.
3+
- Media selection just got more accessible for everyone.

WordPress/metadata/PlayStoreStrings.po

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,13 @@ msgstr ""
1010
"X-Generator: VsCode\n"
1111
"Project-Id-Version: Release Notes & Play Store Descriptions\n"
1212

13+
msgctxt "release_note_262"
14+
msgid ""
15+
"26.2:\n"
16+
"- We've added support for mentions in the experimental editor—tag your friends and collaborators with ease.\n"
17+
"- Media selection just got more accessible for everyone.\n"
18+
msgstr ""
19+
1320
msgctxt "release_note_261"
1421
msgid ""
1522
"26.1:\n"
@@ -18,12 +25,6 @@ msgid ""
1825
"- Fixed various upload bugs and improved overall media handling.\n"
1926
msgstr ""
2027

21-
msgctxt "release_note_260"
22-
msgid ""
23-
"26.0:\n"
24-
"We’ve added Application Passwords authentication. It’s still experimental, but once it’s fully integrated, we’ll be able to improve existing features and introduce new ones. Rock on.\n"
25-
msgstr ""
26-
2728
#. translators: Release notes for this version to be displayed in the Play Store. Limit to 500 characters including spaces and commas!
2829
#. translators: Shorter Release notes for this version to be displayed in the Play Store. Limit to 500 characters including spaces and commas!
2930
msgctxt "sample_post_content"
Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,2 @@
1-
- Media now displays properly on private sites in the experimental editor.
2-
- Enhanced media uploads with better authentication and improved performance.
3-
- Fixed various upload bugs and improved overall media handling.
1+
- We've added support for mentions in the experimental editor—tag your friends and collaborators with ease.
2+
- Media selection just got more accessible for everyone.

fastlane/resources/values/strings.xml

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -978,8 +978,6 @@
978978
<string name="experimental_subscribers_feature_description">View and manage newsletter subscribers</string>
979979
<string name="experimental_application_password_feature">Application Password log in</string>
980980
<string name="experimental_application_password_feature_description">Enable Application Password to log into self-hosted sites</string>
981-
<string name="experimental_jetpack_rest_connection">Experimental Jetpack REST Connection</string>
982-
<string name="experimental_jetpack_rest_connection_description">Enable experimental Jetpack REST Connection flow</string>
983981

984982
<!-- Debug settings -->
985983
<string name="preference_open_debug_settings" translatable="false">Debug Settings</string>
@@ -1009,23 +1007,29 @@
10091007

10101008
<!-- Jetpack REST Connection Screen -->
10111009
<string name="jetpack_rest_connection_title">Jetpack Connection</string>
1012-
<string name="jetpack_rest_connection_setup_title">Setting up Jetpack (Simulated)</string>
1010+
<string name="jetpack_rest_connection_setup_title">Setting up Jetpack</string>
10131011
<string name="jetpack_rest_connection_step_login_wpcom">Login to WordPress.com</string>
10141012
<string name="jetpack_rest_connection_step_install_jetpack">Install Jetpack plugin</string>
1015-
<string name="jetpack_rest_connection_step_connect_site">Connect your site</string>
1016-
<string name="jetpack_rest_connection_step_connect_wpcom">Connect to WordPress.com</string>
1013+
<string name="jetpack_rest_connection_step_connect_site">Connect site to WordPress.com</string>
1014+
<string name="jetpack_rest_connection_step_connect_user">Connect user to WordPress.com</string>
10171015
<string name="jetpack_rest_connection_step_finalize">Finalize setup</string>
10181016
<string name="jetpack_rest_connection_status_not_started">Not started</string>
10191017
<string name="jetpack_rest_connection_status_in_progress">In progress…</string>
10201018
<string name="jetpack_rest_connection_status_completed">Completed</string>
10211019
<string name="jetpack_rest_connection_status_failed">Failed</string>
10221020
<string name="jetpack_rest_connection_cancel_title">Cancel Jetpack Setup?</string>
10231021
<string name="jetpack_rest_connection_cancel_message">The Jetpack connection process is in progress. Are you sure you want to cancel?</string>
1024-
<string name="jetpack_rest_connection_error_jetpack_already_installed">Jetpack is already installed</string>
10251022
<string name="jetpack_rest_connection_error_timeout">Timed out</string>
10261023
<string name="jetpack_rest_connection_error_unknown" translatable="false">@string/error_generic</string>
10271024
<string name="jetpack_rest_connection_error_offline" translatable="false">@string/no_network_title</string>
1028-
<string name="jetpack_rest_connection_error_wpcom">Unable to connect to WordPress.com</string>
1025+
<string name="jetpack_rest_connection_error_login_wpcom">Unable to log into WordPress.com</string>
1026+
<string name="jetpack_rest_connection_error_connect_wpcom">Unable to connect to WordPress.com</string>
1027+
<string name="jetpack_rest_connection_error_install_jetpack">Install failed</string>
1028+
<string name="jetpack_rest_connection_error_install_jetpack_inactive">Jetpack installed but inactive</string>
1029+
<string name="jetpack_rest_connection_error_connect_site">Failed to connect to site</string>
1030+
<string name="jetpack_rest_connection_error_connect_user">Failed to connect user to WordPress.com</string>
1031+
<string name="jetpack_rest_connection_error_access_token">Access token missing</string>
1032+
<string name="jetpack_rest_connection_error_activate_stats">Failed to activate stats</string>
10291033

10301034
<!-- Stats refresh -->
10311035
<string name="stats_no_data_yet">No data yet</string>
@@ -1576,6 +1580,7 @@
15761580
<string name="notifications_jetpack_connection_setup_info">To get helpful notifications on your device from your WordPress site, you\'ll need to install the Jetpack plugin. Would you like to set up Jetpack?</string>
15771581
<string name="notifications_empty_view_reader">Go to Reader</string>
15781582
<string name="content_description_person_reading_device_notification">Person reading device with notifications</string>
1583+
<string name="content_description_empty_view">Image illustrating that the view is empty</string>
15791584
<string name="older_two_days">Older than 2 days</string>
15801585
<string name="older_last_week">Older than a week</string>
15811586
<string name="older_month">Older than a month</string>
@@ -5071,4 +5076,7 @@ translators: %s: Select control option value e.g: "Auto, 25%". -->
50715076
<string name="application_password_name_sort">Name</string>
50725077
<string name="application_password_created_sort">Created</string>
50735078
<string name="application_password_last_used_sort">Last used</string>
5079+
5080+
<!-- DataView -->
5081+
<string name="dataview_default_empty_message">There\'s nothing here</string>
50745082
</resources>

version.properties

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
1-
versionName=26.1
2-
versionCode=1472
1+
versionName=26.2-rc-1
2+
versionCode=1473

0 commit comments

Comments
 (0)