|
2 | 2 |
|
3 | 3 | All notable changes to the BOOST data standard are documented in this file. |
4 | 4 |
|
| 5 | +## [3.2.1] - 2025-08-14 - ReSpec Layout System Restoration |
| 6 | + |
| 7 | +### Fixed |
| 8 | +- **🎨 ReSpec-Style Layout System** - Restored sophisticated ReSpec-style layout from commit v3.1.3-5-g725c24a |
| 9 | + - **User Feedback Response**: Addressed critical HTML formatting regression that broke document styling |
| 10 | + - **Layout System Restoration**: Restored `main-content-wrapper` div structure for proper responsive layout |
| 11 | + - **Python HTML Processing**: Restored sophisticated HTML processing in build.sh to remove Bikeshed centering constraints |
| 12 | + - **CSS Integration**: Restored `respec-style.css` with fixed sidebar TOC navigation and responsive design |
| 13 | + - **Workflow Validation**: Fixed workflow to check for `main-content-wrapper` instead of incorrect `h-entry` elements |
| 14 | +- **🔧 Build Process Integration** - ReSpec-style layout system properly integrated with CI/CD pipeline |
| 15 | + - **HTML Generation**: Bikeshed generates base HTML, Python processing applies ReSpec layout structure |
| 16 | + - **Responsive Design**: Proper sidebar collapse/expand functionality with mobile compatibility |
| 17 | + - **Navigation Enhancement**: Fixed TOC with smooth scrolling and section highlighting |
| 18 | + - **Cross-Browser Compatibility**: Consistent layout rendering across modern browsers |
| 19 | + |
| 20 | +### Enhanced |
| 21 | +- **📱 User Experience** - Restored professional document presentation with proper navigation |
| 22 | + - **Sidebar Navigation**: Fixed TOC with expand/collapse functionality and smooth scrolling |
| 23 | + - **Responsive Layout**: Proper mobile and desktop layout adaptation |
| 24 | + - **Content Readability**: Restored proper content width and spacing for optimal reading experience |
| 25 | + - **Visual Consistency**: Maintained ReSpec visual styling while using Bikeshed as content generator |
| 26 | + |
| 27 | +### Technical Improvements |
| 28 | +- **🏗️ Build System Architecture** - Hybrid approach combining Bikeshed content generation with ReSpec presentation |
| 29 | + - **Content Generation**: Bikeshed generates semantic HTML with proper specification structure |
| 30 | + - **Layout Processing**: Python processing applies ReSpec-style layout without affecting content semantics |
| 31 | + - **CSS Override System**: Strategic CSS overrides remove Bikeshed centering while preserving document structure |
| 32 | + - **Validation Integration**: Workflow validation ensures proper layout application in CI/CD pipeline |
| 33 | + |
| 34 | +### User Impact |
| 35 | +- **📖 Documentation Quality** - Professional document presentation suitable for standards publication |
| 36 | +- **🎯 Navigation Experience** - Intuitive sidebar navigation with section highlighting and smooth scrolling |
| 37 | +- **📱 Mobile Compatibility** - Responsive design ensuring accessibility across all device types |
| 38 | +- **🔗 Link Functionality** - Proper internal linking and cross-references throughout the document |
| 39 | + |
| 40 | +*This restoration addresses critical user feedback about HTML formatting changes, restoring the sophisticated ReSpec-style layout system that provides professional document presentation while maintaining Bikeshed's semantic content generation capabilities.* |
| 41 | + |
5 | 42 | ## [3.2.0] - 2025-08-14 - Build System Consolidation and Version Nomenclature |
6 | 43 |
|
7 | 44 | ### Added |
|
0 commit comments