Add comprehensive CLI documentation and examples

[aryaman-vohra]

📝 What This PR Adds:

• Closes Create documentation for GoFr CMD #2075.

✅ Complete CLI Documentation

• New file: docs/cli/cli.md - Comprehensive guide for building CLI applications
• Navigation: Updated docs/navigation.js with CLI entry
• Version-aware: Documents current GoFr limitations and manual argument parsing

✅ Working CLI Examples

• Multi-subcommand example: examples/cli-example/example1-mutli-sub-command/main.go

  • Supports both hello and goodbye subcommands
  • Demonstrates flag (--name) and positional argument parsing

• Single subcommand example: examples/cli-example/example2-single-sub-command/main.go

  • Simple hello command with manual argument parsing

• Documentation: examples/cli-example/README.md with usage instructions

✅ Key Features Demonstrated:

• Manual argument parsing using os.Args and helper functions
• Both flag-based (--name value) and positional arguments
• Default value handling
• Multiple subcommands in single application
• Proper error handling and exit codes
• Testing approaches for CLI commands

✅ Documentation Quality:

• Clear examples with runnable code
• Best practices for CLI development
• Version compatibility notes
• Comprehensive testing guidance
• Comparison with HTTP applications

🎯 Impact:

This PR provides users with complete documentation and working examples for building CLI applications with the current GoFr version, addressing the lack of CLI documentation in the project.

📋 Files Changed:

• ✨ NEW: docs/cli/cli.md
• ✨ NEW: examples/cli-example/README.md
• ✨ NEW: examples/cli-example/example1-mutli-sub-command/main.go
• ✨ NEW: examples/cli-example/example2-single-sub-command/main.go
• 🔧 MODIFIED: docs/navigation.js

🧪 Testing:

All examples are tested and working with the current GoFr version. Users can run:

go run examples/cli-example/example1-mutli-sub-command/main.go hello
go run examples/cli-example/example2-single-sub-command/main.go hello --name World

[aryaman-vohra]

@coolwednesday can u review this?

[Umang01-hash]

This change is not needed please revert it.

[Umang01-hash]

I feel all the changes in the go.work.sum are not related to scope of this PR so please revert them back.

[Umang01-hash]

Thanks for such a detailed documentation but having so much can actually confuse the user on what's important and what's for the info only.

I will kindly request you to make a simple short yet informatic documentation giving all the necessary commands and method that GoFr provides along with a small example and only the most necessary info. Please feel free to visit our https://gofr.dev/docs website to refer how other docs are written.

[Umang01-hash]

@aryaman-vohra For the issue #2075 we need to add a documentation for CLI but no need to write a new CLI example. If you want to update the readme please update sample cmd example readme. Please remove the newly added example as we already have one cmd example.