v2.3.1 - Status Element Compliance & Documentation

🎯 Status Element Compliance & Documentation Release

This patch release focuses on 100% Atlassian ADF compliance for status elements and comprehensive user documentation.

✨ Status Element Improvements

📋 Compliance with Official Atlassian Specification

• ✅ Schema Updated: Removed non-standard style attribute
• ✅ Official Attributes: text (required), color (required), localId (optional)
• ✅ Official Colors: neutral, green, red, yellow, blue, purple
• ✅ Backward Compatibility: Custom attributes preserved in metadata

📚 Enhanced Documentation

Quick Start Guide Improvements

• New Status Format Standards section with comprehensive examples
• Clear syntax guidance: {status:In Progress} for basic usage
• Advanced colored status: <!-- adf:status color="green" -->{status:Complete}
• Integration examples with other social elements
• Next Steps section now includes social elements category

Specification Documentation

• Updated element specifications to match official Atlassian docs exactly
• Removed non-standard attributes from documentation and examples
• Comprehensive test fixtures updated for compliance
• Round-trip conversion accuracy maintained

🔧 Technical Improvements

Test Suite Updates

• ✅ 13 comprehensive test cases for status converter
• ✅ Updated fixtures to remove non-standard attributes
• ✅ Integration tests with panels, tables, and lists
• ✅ Backward compatibility tests for custom attributes

Implementation Details

• StatusConverter preserves all attributes in metadata for compatibility
• ADF to Markdown: `Status Text` with metadata comments
• Markdown to ADF: Proper status nodes with required attributes
• Round-trip accuracy: No data loss through multiple conversions

🎯 User Impact

For New Users

• Clear documentation on how to create status elements
• Official Atlassian compliance ensures compatibility
• Comprehensive examples for basic and advanced usage

For Existing Users

• No breaking changes - all existing functionality preserved
• Enhanced compliance improves Atlassian platform integration
• Better documentation for easier implementation

📊 Status Element Usage Examples

Basic Status

Task status: {status:In Progress}

Colored Status

<!-- adf:status color="green" -->
{status:Complete}

<!-- adf:status color="red" -->
{status:Blocked}

Available Colors

• neutral (default - grey)
• green (success/complete)
• red (error/blocked)
• yellow (warning/in progress)
• blue (info)
• purple (custom)

🔗 Related Links

• Status Element Specification
• Quick Start Guide
• Atlassian ADF Documentation

---

Full Changelog: v2.3.0...v2.3.1

This release maintains 100% backward compatibility while ensuring full compliance with the official Atlassian Document Format specification.