⚠️ UPGRADE NOTICE: v0.5.0 Released - Breaking Changes

[costiash]

🚨 Action Required for Existing Users

v0.5.0 has been released with breaking changes. If you installed before December 6, 2025, please upgrade.

Why Upgrade?

Before (v0.4.x)	After (v0.5.0)
~270 docs	571 docs (2x coverage!)
Old naming convention	Domain-based naming
No safety thresholds	3 safeguards against data loss

How to Upgrade

Simply re-run the installer:

curl -fsSL https://raw.githubusercontent.com/costiash/claude-code-docs/main/install.sh | bash

The installer will:

1. ✅ Detect your existing installation
2. ✅ Show you what's changing
3. ✅ Perform an atomic upgrade
4. ✅ Verify the installation

How to Check Your Version

~/.claude-code-docs/claude-docs-helper.sh --version

If you see v0.4.x, you need to upgrade.

---

Release Notes: https://github.com/costiash/claude-code-docs/releases/tag/v0.5.0

This issue will be closed once the upgrade window has passed (January 2026).

[costiash]

cc @hesreallyhim - Since you've been keeping an eye on this project (and kindly included it in Awesome Claude Code 🙏), wanted to let you know about this major release!

v0.5.0 highlights:

• 📚 2x documentation coverage (571 files)
• 🛡️ Safety thresholds to prevent accidental data loss
• 🔄 Seamless upgrade path for existing users

If you think it's worth updating the awesome-claude-code listing to mention the new version, that would be amazing - but no pressure at all!

Thanks for supporting the Claude Code community! 🚀
(The actual important part here is the added safeguards to the automatic docs updates. Because Anthropic constantly moving things around, it causes sitemaps url fetching break and can cause to unstable behavior regarding the saved documentations. So after by chance noticed it had to implement these fixes and used already the opportunity to introduce some more improvements and refactoring)