diff --git a/README.md b/README.md index 5955f7c..e93f7cd 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,16 @@ [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) [![Coverage](https://img.shields.io/badge/coverage-80%25+-brightgreen)](https://github.com/workflow-kit/pr-auto-labeler) + +[![GitHub stars](https://img.shields.io/github/stars/workflow-kit/pr-auto-labeler?style=social)](https://github.com/workflow-kit/pr-auto-labeler/stargazers) +[![GitHub forks](https://img.shields.io/github/forks/workflow-kit/pr-auto-labeler?style=social)](https://github.com/workflow-kit/pr-auto-labeler/network/members) +[![GitHub watchers](https://img.shields.io/github/watchers/workflow-kit/pr-auto-labeler?style=social)](https://github.com/workflow-kit/pr-auto-labeler/watchers) +[![GitHub issues](https://img.shields.io/github/issues/workflow-kit/pr-auto-labeler)](https://github.com/workflow-kit/pr-auto-labeler/issues) +[![GitHub pull requests](https://img.shields.io/github/issues-pr/workflow-kit/pr-auto-labeler)](https://github.com/workflow-kit/pr-auto-labeler/pulls) +[![Used by (public repos)](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.github.com%2Frepos%2Fworkflow-kit%2Fpr-auto-labeler%2Fnetwork%2Fdependents&query=%24.length&label=used%20by&logo=github)](https://github.com/workflow-kit/pr-auto-labeler/network/dependents) +[![Last commit](https://img.shields.io/github/last-commit/workflow-kit/pr-auto-labeler)](https://github.com/workflow-kit/pr-auto-labeler/commits/main) +[![Release](https://img.shields.io/github/v/release/workflow-kit/pr-auto-labeler?include_prereleases)](https://github.com/workflow-kit/pr-auto-labeler/releases) + ## 📸 See It In Action ![PR Auto-Labeler Preview](.github/images/pr-labels-preview.png) @@ -453,6 +463,32 @@ Want to add a new rule or improve existing ones? See [CONTRIBUTING.md](CONTRIBUT --- +## 📊 Usage Analytics + +Want to see how widely this action is used? Here's what the badges track: + +| Badge | What It Measures | Why It Matters | +|-------|------------------|----------------| +| ⭐ **Stars** | Community interest & endorsement | Shows how many developers find this useful | +| 🔱 **Forks** | Active usage & customization | Indicates real adoption (people building on it) | +| 👁️ **Watchers** | Active monitoring | Shows engaged users tracking updates | +| 🔗 **Used by** | Public repos using this action | Direct measure of adoption in production | +| 📝 **Issues/PRs** | Community engagement | Shows active maintenance & support | + +**Note:** GitHub only tracks public repository usage. Private repos using this action won't appear in these metrics, so actual usage is likely **2-5x higher** than shown. + +### How Marketplace Analytics Work + +Once published to GitHub Marketplace (coming soon!), you'll get access to: +- ✅ Download counts +- ✅ Installation metrics +- ✅ Usage trends over time +- ✅ Geographic distribution + +The Marketplace insights will be available at: `github.com/marketplace/actions/YOUR-ACTION-NAME` (after publication). + +--- + ## 📚 Documentation - **📖 Design Philosophy:** [docs/DESIGN.md](docs/DESIGN.md)