From bbd2a240a8ff75971ca20962387bb4a11c237288 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 27 Aug 2025 07:18:16 +0000
Subject: [PATCH 1/3] Initial plan


From ef51c5aedc0613c95b3a8ce14631af521ba1c20f Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 27 Aug 2025 07:26:27 +0000
Subject: [PATCH 2/3] Add comprehensive documentation for release commands

Co-authored-by: greymag <1502131+greymag@users.noreply.github.com>
---
 README.md | 54 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 53 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 30cd737..7b57a1a 100644
--- a/README.md
+++ b/README.md
@@ -84,7 +84,59 @@ More about specified configuration parameters - in modules descriptions in the [
 ## Commands
 
 ### Release
-// TODO @chessmax: `release` command description
+
+Manage app releases with automated version control, changelog updates, and build processes.
+
+```
+alex release <command>
+```
+
+#### Start release
+
+Start a new release process using gitflow:
+- checkout and create release branch from `develop`
+- increment version number
+- update CHANGELOG.md
+- validate translations (optional)
+- run pre-release scripts (if configured)
+- generate release notes (with ChatGPT if API key is configured)
+- create local builds (optional)
+- finish release and merge to `master`
+
+```
+alex release start
+```
+
+**Options:**
+
+- `--check_locale=<LOCALE>` (`-l`) - Locale to check before release if translations exist for all strings. If not specified, "en" locale will be checked.
+- `--skip_l10n` (`-s`) - Skip localization process during release.
+- `--local` (`-b`) - Run local release build for Android and iOS platforms.
+- `--entry-point=<path>` (`-e`) - Entry point of the app (e.g., lib/main_test.dart). Only for local release builds.
+- `--platforms=<PLATFORMS>` (`-p`) - Target build platforms: ios, android. You can pass multiple platforms separated by commas. Defaults to "android,ios".
+- `--demo` - Run command in demonstration mode for testing.
+
+**Examples:**
+
+Basic release (default mode):
+```
+alex release start
+```
+
+Local build for testing:
+```
+alex release start --local
+```
+
+Release with custom entry point and specific platform:
+```
+alex release start --local --entry-point=lib/main_dev.dart --platforms=android
+```
+
+Skip localization process:
+```
+alex release start --skip_l10n
+```
 
 ### Feature
 

From 0983de2c28ba880cd949e8da92b81b482f297d95 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 27 Aug 2025 16:01:47 +0000
Subject: [PATCH 3/3] Update release documentation based on review feedback

Co-authored-by: greymag <1502131+greymag@users.noreply.github.com>
---
 README.md | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 7b57a1a..ab1f7eb 100644
--- a/README.md
+++ b/README.md
@@ -110,11 +110,10 @@ alex release start
 **Options:**
 
 - `--check_locale=<LOCALE>` (`-l`) - Locale to check before release if translations exist for all strings. If not specified, "en" locale will be checked.
-- `--skip_l10n` (`-s`) - Skip localization process during release.
+- `--skip_l10n` (`-s`) - Skip translations check during release.
 - `--local` (`-b`) - Run local release build for Android and iOS platforms.
 - `--entry-point=<path>` (`-e`) - Entry point of the app (e.g., lib/main_test.dart). Only for local release builds.
-- `--platforms=<PLATFORMS>` (`-p`) - Target build platforms: ios, android. You can pass multiple platforms separated by commas. Defaults to "android,ios".
-- `--demo` - Run command in demonstration mode for testing.
+- `--platforms=<PLATFORMS>` (`-p`) - Target build platforms: ios, android. You can pass multiple platforms separated by commas. Defaults to "android,ios". Only for local release builds.
 
 **Examples:**
 
@@ -123,7 +122,7 @@ Basic release (default mode):
 alex release start
 ```
 
-Local build for testing:
+Local build for manual upload to store or any other distribution:
 ```
 alex release start --local
 ```
@@ -133,7 +132,7 @@ Release with custom entry point and specific platform:
 alex release start --local --entry-point=lib/main_dev.dart --platforms=android
 ```
 
-Skip localization process:
+Skip translations check:
 ```
 alex release start --skip_l10n
 ```