From 2597d18f5cad074400daf7abde0c800a4c30999e Mon Sep 17 00:00:00 2001 From: Automattic Release Bot Date: Fri, 29 Aug 2025 14:46:02 -0400 Subject: [PATCH 1/9] Bump version number --- version.properties | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/version.properties b/version.properties index f4af56944352..ba2a9303c86d 100644 --- a/version.properties +++ b/version.properties @@ -1,2 +1,2 @@ -versionName=26.1 -versionCode=1472 \ No newline at end of file +versionName=26.2-rc-1 +versionCode=1473 \ No newline at end of file From 8c8ff90c7e68823eb401fd4f32a7a2b24208f4f9 Mon Sep 17 00:00:00 2001 From: Automattic Release Bot Date: Fri, 29 Aug 2025 14:46:02 -0400 Subject: [PATCH 2/9] Update draft release notes for 26.2 --- WordPress/metadata/release_notes.txt | 3 --- 1 file changed, 3 deletions(-) diff --git a/WordPress/metadata/release_notes.txt b/WordPress/metadata/release_notes.txt index 3ef0eb42232d..e69de29bb2d1 100644 --- a/WordPress/metadata/release_notes.txt +++ b/WordPress/metadata/release_notes.txt @@ -1,3 +0,0 @@ -- Media now displays properly on private sites in the experimental editor. -- Enhanced media uploads with better authentication and improved performance. -- Fixed various upload bugs and improved overall media handling. \ No newline at end of file From 3abba3ef38638789f1057aea0ed6f5d747ac6b62 Mon Sep 17 00:00:00 2001 From: Automattic Release Bot Date: Fri, 29 Aug 2025 14:46:02 -0400 Subject: [PATCH 3/9] Update draft release notes for Jetpack 26.2. --- WordPress/jetpack_metadata/release_notes.txt | 4 ---- 1 file changed, 4 deletions(-) diff --git a/WordPress/jetpack_metadata/release_notes.txt b/WordPress/jetpack_metadata/release_notes.txt index f266ad1db42c..e69de29bb2d1 100644 --- a/WordPress/jetpack_metadata/release_notes.txt +++ b/WordPress/jetpack_metadata/release_notes.txt @@ -1,4 +0,0 @@ -- New Subscribers screen shows all your email and Reader subscribers—now you know who's reading your content. -- Media now displays properly on private sites in the experimental editor. -- Enhanced media uploads with better authentication and improved performance. -- Fixed various upload bugs and improved overall media handling. From 54a1222eca22f42405d42d9d69b8a7b94d6e2af5 Mon Sep 17 00:00:00 2001 From: Automattic Release Bot Date: Fri, 29 Aug 2025 14:46:02 -0400 Subject: [PATCH 4/9] Release Notes: add new section for next version (26.3) --- RELEASE-NOTES.txt | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt index cabba2d0d4c4..9c8b66bfb771 100644 --- a/RELEASE-NOTES.txt +++ b/RELEASE-NOTES.txt @@ -1,5 +1,9 @@ *** PLEASE FOLLOW THIS FORMAT: [] [] +26.3 +----- + + 26.2 ----- From aae0389e24d2fc10484be5f26e5256d79c8a88df Mon Sep 17 00:00:00 2001 From: Oguz Kocer Date: Fri, 29 Aug 2025 15:47:22 -0400 Subject: [PATCH 5/9] Update release notes for 26.2 --- CLAUDE.md | 77 ++++++++++++++++++-- WordPress/jetpack_metadata/release_notes.txt | 3 + WordPress/metadata/release_notes.txt | 2 + 3 files changed, 77 insertions(+), 5 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 8250fce09eb3..7c39ece917ff 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -6,7 +6,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co ### Main Build Commands - `./gradlew assembleWordPressVanillaDebug` - Build debug APK for WordPress app -- `./gradlew assembleJetpackVanillaDebug` - Build debug APK for Jetpack app +- `./gradlew assembleJetpackVanillaDebug` - Build debug APK for Jetpack app - `./gradlew installWordPressVanillaDebug` - Install debug APK to connected device - `./gradlew installJetpackVanillaDebug` - Install debug APK for Jetpack to device @@ -38,7 +38,7 @@ This repository builds two apps from shared codebase: ├── WordPress/ # Main app module ├── libs/ │ ├── fluxc/ # Networking and data layer (FluxC architecture) -│ ├── login/ # Shared login functionality +│ ├── login/ # Shared login functionality │ ├── editor/ # Block editor integration │ ├── image-editor/ # Image editing functionality │ ├── analytics/ # Analytics and tracking @@ -61,7 +61,7 @@ WordPress/src/main/java/org/wordpress/android/ ├── ui/ # UI layer organized by feature │ ├── posts/ # Post creation and management │ ├── reader/ # Content discovery and reading -│ ├── stats/ # Site analytics and statistics +│ ├── stats/ # Site analytics and statistics │ ├── bloggingreminders/ # Posting reminders system │ ├── comments/ # Comment management │ ├── accounts/ # Authentication and signup @@ -85,7 +85,7 @@ WordPress/src/main/java/org/wordpress/android/ ### Code Quality Tools - Android Code Style Guidelines with project-specific Checkstyle and Detekt rules - **Checkstyle**: Java code style enforcement (`config/checkstyle.xml`) -- **Detekt**: Kotlin code analysis (`config/detekt/detekt.yml`) +- **Detekt**: Kotlin code analysis (`config/detekt/detekt.yml`) - **Android Lint**: Built-in Android static analysis - **Line Length**: 120 characters max - **No FIXME**: Use TODO instead of FIXME in committed code @@ -97,4 +97,71 @@ WordPress/src/main/java/org/wordpress/android/ - Remote build cache available for faster builds (requires setup) - Fastlane used for release automation and testing - Secrets managed via `secrets.properties` file (not in repo) -- Pre-commit hooks may modify files during commit \ No newline at end of file +- Pre-commit hooks may modify files during commit + +## Release Notes Compilation Process + +### Overview +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. + +### Step-by-Step Process + +#### 1. Study Previous Release Notes Style +Use `gh` to fetch releases and analyze professional editorialization patterns: +- **Version 25.8**: Raw added in commits `8cd1b4cc268887b9e2de94fb19afc108b011f0da` & `93591923dd9a9c144729952ad0dfbc9306f69894`, editorialized in `8a7fc316cf0acfc2b88b1090e3ca148f2145fa92` +- **Version 25.9**: Raw added in `b4a292cc9c9a30823bfdf8e770479a68362ed500`, editorialized in `dad8fa582856758999c43384ccbe55f34b6d2e17` +- **Version 26.0**: Raw added in `a53234ea6b13adf18acac262ad985f94308191c6` & `63067fb7249cc860d44547bb0d1b8dee975dbe8e`, editorialized in `02854d67c42146e611f0f0dff9feb0fd48dc7fd8` + +Commands: `gh release view 25.8`, `gh release view 25.9`, `gh release view 26.0` (note: no 'v' prefix) + +#### 2. Verify Release Branch and Get Last Release Hash +- Verify current branch follows naming: `release/x.y` (where x.y = last_release + 0.1) +- Get commit hash for last release: `gh release view --json tagName,targetCommitish` +- Confirm current branch is properly ahead of last release tag + +#### 3. Identify Changes Since Last Release +Compare current release branch against last release hash: +```bash +git log ..HEAD --oneline --no-merges +``` +Focus on user-facing changes from squash commit messages. **Important**: When commit messages are unclear or technical, always investigate further: +- Use `gh pr view ` to read PR titles and descriptions +- Look for keywords indicating user-facing changes: "feat:", new functionality, UI changes, user experience +- Be especially careful with feature rollouts that may have technical-sounding commit messages but represent new user functionality +- When in doubt, investigate the PR rather than excluding potentially important features + +#### 4. Compile Raw Release Notes +Create factual summary including: +- Only user-facing changes (exclude CI, refactoring, technical debt) +- Prioritize: New features → Improvements → Performance enhancements +- Use positive language (avoid "bug fix", prefer "improved", "enhanced", "resolved") +- Include rough character counts to gauge condensation needed +- Mark changes as WordPress-specific, Jetpack-specific, or both + +#### 5. User Confirmation +Present raw notes to user for: +- Accuracy verification +- WordPress vs Jetpack feature classification +- Any missing or incorrect changes +- Approval to proceed with editorialization + +#### 6. Editorialization +Transform raw notes using established playful style: +- Keep under 350 characters (accounting for translation expansion) +- Use engaging, user-friendly language +- Reference previous release note styles from step 1 +- Create separate versions for WordPress and Jetpack apps +- Focus on user benefits and experience improvements + +#### 7. Update Release Notes Files +Once user confirms the editorialized release notes, **replace** the contents of the following files (discard any existing content): +- **WordPress release notes**: `WordPress/metadata/release_notes.txt` +- **Jetpack release notes**: `WordPress/jetpack_metadata/release_notes.txt` + +Document any process refinements discovered during execution. + +### Content Guidelines +- **Include**: New features, UI improvements, performance enhancements, user experience changes +- **Exclude**: CI changes, code refactoring, dependency updates, internal technical changes +- **Language**: Positive sentiment, avoid "fix" terminology, focus on improvements and enhancements +- **Priority Order**: New features → Improvements → Performance → Other user-facing changes diff --git a/WordPress/jetpack_metadata/release_notes.txt b/WordPress/jetpack_metadata/release_notes.txt index e69de29bb2d1..cd0cddef37dc 100644 --- a/WordPress/jetpack_metadata/release_notes.txt +++ b/WordPress/jetpack_metadata/release_notes.txt @@ -0,0 +1,3 @@ +- Connect your self-hosted sites to Jetpack with our new streamlined flow—available right from Stats and Notifications. +- We've added support for mentions in the editor—tag your friends and collaborators with ease. +- Media selection just got more accessible for everyone. \ No newline at end of file diff --git a/WordPress/metadata/release_notes.txt b/WordPress/metadata/release_notes.txt index e69de29bb2d1..bba73cde6e36 100644 --- a/WordPress/metadata/release_notes.txt +++ b/WordPress/metadata/release_notes.txt @@ -0,0 +1,2 @@ +- We've added support for mentions in the editor—tag your friends and collaborators with ease. +- Media selection just got more accessible for everyone. From 0084f8c45c4bf3f69c1a2de8da2ae89554fb43e8 Mon Sep 17 00:00:00 2001 From: Automattic Release Bot Date: Fri, 29 Aug 2025 15:52:54 -0400 Subject: [PATCH 6/9] Freeze strings for translation --- fastlane/resources/values/strings.xml | 22 +++++++++++++++------- 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/fastlane/resources/values/strings.xml b/fastlane/resources/values/strings.xml index 7da68312b389..f71aaff8bdf1 100644 --- a/fastlane/resources/values/strings.xml +++ b/fastlane/resources/values/strings.xml @@ -978,8 +978,6 @@ View and manage newsletter subscribers Application Password log in Enable Application Password to log into self-hosted sites - Experimental Jetpack REST Connection - Enable experimental Jetpack REST Connection flow Debug Settings @@ -1009,11 +1007,11 @@ Jetpack Connection - Setting up Jetpack (Simulated) + Setting up Jetpack Login to WordPress.com Install Jetpack plugin - Connect your site - Connect to WordPress.com + Connect site to WordPress.com + Connect user to WordPress.com Finalize setup Not started In progress… @@ -1021,11 +1019,17 @@ Failed Cancel Jetpack Setup? The Jetpack connection process is in progress. Are you sure you want to cancel? - Jetpack is already installed Timed out @string/error_generic @string/no_network_title - Unable to connect to WordPress.com + Unable to log into WordPress.com + Unable to connect to WordPress.com + Install failed + Jetpack installed but inactive + Failed to connect to site + Failed to connect user to WordPress.com + Access token missing + Failed to activate stats No data yet @@ -1576,6 +1580,7 @@ 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? Go to Reader Person reading device with notifications + Image illustrating that the view is empty Older than 2 days Older than a week Older than a month @@ -5071,4 +5076,7 @@ translators: %s: Select control option value e.g: "Auto, 25%". --> Name Created Last used + + + There\'s nothing here From 5d53fb5eed1cdff6315cd94e19a72e7f7278d99f Mon Sep 17 00:00:00 2001 From: Oguz Kocer Date: Fri, 29 Aug 2025 16:38:34 -0400 Subject: [PATCH 7/9] Minor updates to 26.2 release notes --- CLAUDE.md | 1 + WordPress/jetpack_metadata/release_notes.txt | 4 ++-- WordPress/metadata/release_notes.txt | 2 +- 3 files changed, 4 insertions(+), 3 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 7c39ece917ff..58b8e98accf7 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -132,6 +132,7 @@ Focus on user-facing changes from squash commit messages. **Important**: When co #### 4. Compile Raw Release Notes Create factual summary including: +- **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 - Only user-facing changes (exclude CI, refactoring, technical debt) - Prioritize: New features → Improvements → Performance enhancements - Use positive language (avoid "bug fix", prefer "improved", "enhanced", "resolved") diff --git a/WordPress/jetpack_metadata/release_notes.txt b/WordPress/jetpack_metadata/release_notes.txt index cd0cddef37dc..a66a59d35b86 100644 --- a/WordPress/jetpack_metadata/release_notes.txt +++ b/WordPress/jetpack_metadata/release_notes.txt @@ -1,3 +1,3 @@ - Connect your self-hosted sites to Jetpack with our new streamlined flow—available right from Stats and Notifications. -- We've added support for mentions in the editor—tag your friends and collaborators with ease. -- Media selection just got more accessible for everyone. \ No newline at end of file +- We've added support for mentions in the experimental editor—tag your friends and collaborators with ease. +- Media selection just got more accessible for everyone. diff --git a/WordPress/metadata/release_notes.txt b/WordPress/metadata/release_notes.txt index bba73cde6e36..0a123bf68e29 100644 --- a/WordPress/metadata/release_notes.txt +++ b/WordPress/metadata/release_notes.txt @@ -1,2 +1,2 @@ -- We've added support for mentions in the editor—tag your friends and collaborators with ease. +- We've added support for mentions in the experimental editor—tag your friends and collaborators with ease. - Media selection just got more accessible for everyone. From 89e1d2c9fc996ab339b0b0f4e1dbb5c51d7e3bd1 Mon Sep 17 00:00:00 2001 From: Oguz Kocer Date: Fri, 29 Aug 2025 16:39:17 -0400 Subject: [PATCH 8/9] Update WordPress `PlayStoreStrings.po` for version 26.2 --- WordPress/metadata/PlayStoreStrings.po | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/WordPress/metadata/PlayStoreStrings.po b/WordPress/metadata/PlayStoreStrings.po index 08c74b52a773..768f284b40c1 100644 --- a/WordPress/metadata/PlayStoreStrings.po +++ b/WordPress/metadata/PlayStoreStrings.po @@ -10,6 +10,13 @@ msgstr "" "X-Generator: VsCode\n" "Project-Id-Version: Release Notes & Play Store Descriptions\n" +msgctxt "release_note_262" +msgid "" +"26.2:\n" +"- We've added support for mentions in the experimental editor—tag your friends and collaborators with ease.\n" +"- Media selection just got more accessible for everyone.\n" +msgstr "" + msgctxt "release_note_261" msgid "" "26.1:\n" @@ -18,12 +25,6 @@ msgid "" "- Fixed various upload bugs and improved overall media handling.\n" msgstr "" -msgctxt "release_note_260" -msgid "" -"26.0:\n" -"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" -msgstr "" - #. translators: Release notes for this version to be displayed in the Play Store. Limit to 500 characters including spaces and commas! #. translators: Shorter Release notes for this version to be displayed in the Play Store. Limit to 500 characters including spaces and commas! msgctxt "sample_post_content" From d7a010c00500d9a11455061de0806c6e697a3b05 Mon Sep 17 00:00:00 2001 From: Oguz Kocer Date: Fri, 29 Aug 2025 16:39:18 -0400 Subject: [PATCH 9/9] Update Jetpack `PlayStoreStrings.po` for version 26.2 --- WordPress/jetpack_metadata/PlayStoreStrings.po | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/WordPress/jetpack_metadata/PlayStoreStrings.po b/WordPress/jetpack_metadata/PlayStoreStrings.po index d9aa6f721e2e..c09af2730f3d 100644 --- a/WordPress/jetpack_metadata/PlayStoreStrings.po +++ b/WordPress/jetpack_metadata/PlayStoreStrings.po @@ -10,6 +10,14 @@ msgstr "" "X-Generator: VsCode\n" "Project-Id-Version: Jetpack - Apps - Android - Release Notes\n" +msgctxt "release_note_262" +msgid "" +"26.2:\n" +"- Connect your self-hosted sites to Jetpack with our new streamlined flow—available right from Stats and Notifications.\n" +"- We've added support for mentions in the experimental editor—tag your friends and collaborators with ease.\n" +"- Media selection just got more accessible for everyone.\n" +msgstr "" + msgctxt "release_note_261" msgid "" "26.1:\n" @@ -19,12 +27,6 @@ msgid "" "- Fixed various upload bugs and improved overall media handling.\n" msgstr "" -msgctxt "release_note_260" -msgid "" -"26.0:\n" -"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" -msgstr "" - #. translators: Release notes for this version to be displayed in the Play Store. Limit to 500 characters including spaces and commas! #. translators: Title to be displayed in the Play Store. Limit to 30 characters including spaces and commas! msgctxt "play_store_app_title"