name: doc-formatter description: Format documentation with emojis, status bars, and versioning matrix. Use when creating or updating README files, documentation, specs, or any markdown files.
Documentation Formatter
Ensures all documentation has consistent formatting with emojis, status indicators, and version tracking.
Required Elements
1. Emojis for Section Headers
Use these emojis consistently:
| Section | Emoji |
|---|---|
| Overview/About | 📋 |
| Features | ✨ |
| Installation | 📦 |
| Quick Start | 🚀 |
| Usage | 💡 |
| Configuration | ⚙️ |
| API/Reference | 📚 |
| Examples | 📝 |
| Testing | 🧪 |
| Deployment | 🌐 |
| Contributing | 🤝 |
| Changelog | 📜 |
| License | 📄 |
| Warning/Caution | ⚠️ |
| Important | ❗ |
| Tip/Note | 💡 |
| Success | ✅ |
| Error/Fail | ❌ |
| In Progress | 🔄 |
| Deprecated | ⛔ |
2. Status Bars (Shields.io Badges)
Include at the top of every README:
Status Options
Active(green/success)Maintenance(yellow/warning)Deprecated(red/critical)Beta(blue/informational)Alpha(purple)
3. Versioning Matrix
Include a compatibility/version matrix table:
## 📊 Version Matrix
| Version | Status | Release Date | Node | Python | Notes |
|---------|--------|--------------|------|--------|-------|
| 3.0.0 | ✅ Current | Dec 2025 | 18+ | 3.9+ | Major refactor |
| 2.1.0 | 🔄 Maintained | Nov 2025 | 16+ | 3.8+ | Security fixes only |
| 1.x.x | ⛔ Deprecated | Oct 2024 | 14+ | 3.7+ | No longer supported |
Adapt columns based on project type (languages, frameworks, APIs, etc.)
Template
<div align="center">
# 📋 Project Name
Brief description here.
</div>
---
## ✨ Features
- Feature 1
- Feature 2
## 🚀 Quick Start
1. Step one
2. Step two
## 📊 Version Matrix
| Version | Status | Release Date | Notes |
|---------|--------|--------------|-------|
| 1.0.0 | ✅ Current | Dec 2025 | Initial release |
## ⚙️ Configuration
Configuration details...
## 📚 API Reference
API documentation...
## 🧪 Testing
How to run tests...
## 🤝 Contributing
Contribution guidelines...
## 📜 Changelog
See [CHANGELOG.md](CHANGELOG.md)
## 📄 License
License information...
---
*Last Updated: December 2025*
Formatting Rules
- Every major section gets an emoji prefix
- Status badges go at the top, centered
- Version matrix required for any project with releases
- Tables should use emoji status indicators (✅ ❌ 🔄 ⛔)
- Code blocks should specify language for syntax highlighting
- Links should be descriptive, not "click here"
When to Apply
Apply this formatting when:
- Creating new README.md files
- Updating existing documentation
- Writing spec documents
- Creating CHANGELOG files
- Any markdown file in the project