Repository navigation
v2.3.2 - Enhanced Status Elements with Inline Color Syntax
π Enhanced Status Elements - v2.3.2
β¨ Major Enhancement: Inline Color Syntax
We've completely revamped the status element syntax to make it much more user-friendly and intuitive!
π New Inline Color Syntax
{status:Complete|color:green} # Success states
{status:Blocked|color:red} # Error states
{status:In Progress|color:yellow} # Warning states
{status:Available|color:blue} # Info states
{status:High Priority|color:purple} # Priority states
{status:Draft|color:neutral} # Default statesπ Practical Examples
# Project Status Dashboard
**Authentication Module**: {status:Complete|color:green}
**Dashboard UI**: {status:In Progress|color:yellow}
**API Integration**: {status:Blocked|color:red}
**Testing**: {status:Not Started}
## Team Availability
- **Alice Johnson**: {status:Available|color:blue}
- **Bob Smith**: {status:Busy|color:neutral}
- **Carol Davis**: {status:On Vacation|color:purple}π Migration from Legacy Syntax
# Old syntax (still works for backward compatibility)
<!-- adf:status color="green" -->
{status:Complete}
# New syntax (recommended)
{status:Complete|color:green}π Key Features
- β User-Friendly: Clean, intuitive inline syntax
- β Round-Trip Compatible: Perfect Markdown β ADF conversion
- β Atlassian Compliant: Official ADF specification colors and attributes
- β
Backward Compatible: Legacy
{status:text}format still supported - β Comprehensive: All 6 official Atlassian status colors supported
π¨ Available Colors
| Color | Use Case | Example |
|---|---|---|
neutral |
Default, draft states | {status:Draft|color:neutral} |
green |
Success, complete, approved | {status:Complete|color:green} |
red |
Error, blocked, critical | {status:Blocked|color:red} |
yellow |
Warning, in progress, pending | {status:In Progress|color:yellow} |
blue |
Information, available, active | {status:Available|color:blue} |
purple |
Priority, review, special | {status:High Priority|color:purple} |
π§ Technical Improvements
- Enhanced parsing regex with robust color validation
- Updated StatusConverter for perfect round-trip conversion
- Comprehensive test coverage with 42+ status-related tests
- Full documentation updates across all user guides
π Updated Documentation
- Enhanced quick-start guide with practical examples
- Updated markdown-to-adf conversion documentation
- Comprehensive element specifications with migration guide
- All examples updated to showcase new syntax
π§ͺ Quality Assurance
- All status-related tests passing (42 tests)
- Round-trip conversion validated
- Integration with tables, panels, and mixed content verified
- Backward compatibility maintained and tested
Upgrade today to enjoy the much more intuitive status element syntax while maintaining full compatibility with existing documents!