Skip to content

Conversation

@javoire
Copy link
Owner

@javoire javoire commented Nov 28, 2025

Streamlines the README by moving detailed content into separate docs files, making the main README more concise and easier to scan.

Changes

README now includes:

  • Features overview
  • Homebrew installation (primary method)
  • Quick start guide
  • Command summary with links
  • Documentation links

New docs files:

  • docs/alternative-installations.md - Go install, binary download, build from source
  • docs/commands.md - Full command reference with all flags
  • docs/configuration.md - Configuration options
  • docs/examples.md - Workflow examples
  • docs/how-it-works.md - Stack tracking and sync algorithm
  • docs/troubleshooting.md - Common issues and solutions

README reduced from ~290 lines to ~100 lines while maintaining discoverability through links.

@javoire javoire merged commit e30a6d5 into main Nov 28, 2025
1 check passed
@javoire javoire deleted the docs/reorganize-readme branch November 28, 2025 18:19
@javoire
Copy link
Owner Author

javoire commented Nov 28, 2025

🎉 This PR is included in version 1.1.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants