what

We would be fixing the following UX issues with help in this pr:

• atmos about non-existent should show usage:
  

• Double dash in flags of atmos terraform --help and examples rendering using markdown if available.
  

• Fixed atmos workflow --file example.yaml bug for markdown. Now it also exits with exit code 1.
  

• Updated Default error logger with markdown support.
  

• Added custom alias help support so that alias in config should also be displayed in help.
  

• Updated the workflow name invalid UI
  

• Invalid custom command config now shows better help
  

• Invalid flag usage added
  

why

• Outputting markdown in help descriptions makes it easier to visually parse
• Markdown stylesheet keeps formatting consistent, without each developer needing to know the style guide
• Changed the way error that exit are displayed, to show more helpful information and usage examples, also formatted in markdown
• Aliases were not shown in help, making their discoverability difficult

references

• DEV-2950
• DEV-2690

Summary by CodeRabbit

• Enhanced CLI Experience

  • Error messages, usage, and help outputs across multiple Atmos commands are now displayed using a clear Markdown format. Users receive more descriptive feedback for invalid commands or flags and improved prompts during execution.
  • Specific error messages have been improved to include context and suggestions for available workflows and commands, particularly when workflows are not found or when invalid commands are issued.
  • New error messages provide clear guidance when invalid or non-existent commands are invoked, listing valid options for user convenience.
  • The command atmos terraform now specifies required subcommands and provides usage examples when invoked incorrectly.

• Updated Documentation

  • Command usage examples and help texts for key functionality (such as for Atmos “about,” “terraform,” “workflow,” “helmfile,” and “atlantis” commands) have been refined, offering clearer guidance and structured instructions for end-user workflows.
  • New sections have been added to documentation, detailing how to apply changes to Terraform components and providing examples for using workflow commands effectively.
  • Additional help messages have been introduced for commands like atmos validate editorconfig, enhancing user understanding of available flags and options.
  • Documentation updates reflect the latest versions of Atmos and Geodesic tools, ensuring users have the most current information for their workflows.