Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Aug 27, 2025

This PR addresses the TODO comment in the README.md file by adding complete documentation for the alex release command section.

Changes Made

Documentation Added:

  • Comprehensive description of the release command and its automated workflow
  • Detailed explanation of the gitflow-based release process including:
    • Branch management (develop → release → master)
    • Version increment
    • Changelog updates
    • Translation validation
    • Pre-release script execution
    • Release notes generation (with ChatGPT integration)
    • Local build support

Command Options Documented:

  • --check_locale (-l) - Translation validation for specific locales
  • --skip_l10n (-s) - Skip translations check during release
  • --local (-b) - Run local release builds
  • --entry-point (-e) - Custom app entry point for builds
  • --platforms (-p) - Target build platforms (iOS/Android, only for local builds)

Examples Provided:

  • Basic release in default mode: alex release start
  • Local build for manual upload to store or distribution: alex release start --local
  • Advanced usage with custom entry points and platform selection
  • Skipping translations check during release

The documentation follows the existing README.md formatting style and structure, maintaining consistency with other command sections like Feature and l10n. Developer-specific options like --demo are excluded to keep the documentation focused on end users.

Validation

  • All examples were tested using the --demo flag to ensure they work correctly
  • Static analysis passes with no issues
  • All existing tests continue to pass
  • CLI functionality verified

Fixes #47.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI changed the title [WIP] Describe commands from "release" section Add comprehensive documentation for release commands Aug 27, 2025
Copilot AI requested a review from greymag August 27, 2025 07:27
README.md Outdated
- `--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".
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is only for local builds too

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added clarification that --platforms is "Only for local release builds" to make it clear when this option applies. (0983de2)

@greymag
Copy link
Contributor

greymag commented Aug 27, 2025

@copilot make changes according to my comments

Copy link
Contributor Author

Copilot AI commented Aug 27, 2025

@copilot make changes according to my comments

Made all the requested changes in the documentation:

  • Updated --skip_l10n description to clarify it skips translations check
  • Removed --demo option from README
  • Clarified --platforms is only for local builds
  • Changed local build examples to reference manual distribution instead of testing
  • Fixed all related descriptions for consistency

All changes validated with static analysis and CLI functionality tests. (0983de2)

Copilot AI requested a review from greymag August 27, 2025 16:03
@greymag greymag marked this pull request as ready for review August 28, 2025 06:20
@greymag greymag merged commit 720e06c into master Aug 28, 2025
1 check passed
@greymag greymag deleted the copilot/fix-47 branch August 28, 2025 06:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Describe commands from "release" section

2 participants