In this section, you will find the release notes for each version we release under this major version. If you are looking for the release notes of previous major versions, use the version switcher at the top left of this documentation book. Here is a breakdown of our major version releases.

Version 5.0

Major release adding full BoxLang support, modern HTML themes with dark mode, enhanced UI/UX with real-time search, complete relationship documentation, and comprehensive developer experience improvements.

Version 4.0

This major bump was to deprecate some CFML engines

Version 3.0

Added a JSON strategy in preparation for multiple output strategies we will support. Updated build processes and a new outlook for the future of the project.

Version 2.0

The migration from ColdDoc into DocBox.

BREAKING

• Dropped support for Adobe 2016. Adobe doesn't support ACF 16 anymore, so neither do we.

NEW

• Added support for Adobe 2021

• Added support for @myCustomTag custom docblock tags on methods. (Already supported on components and properties, but missing on methods).

• Added GitHub Actions CI for automated testing, format checking, releases and more

FIX

• Fixes support for Adobe 2018. (Mainly in the CommandBox strategy.)

Added

• Adobe 2023 Testing and Support

• New Github Actions

• New supporting files

• New build/Docs.cfc task for building the documentation using itself, before we where getting away with it because there was a previous DocBox version. Now we need to build the docs with the current version of DocBox.

Fixed

• Build Versions and changelog

• Removal of box.zip in root from old scripts

📚 DocBox reads class metadata and structured comments and outputs documentation in an HTML, JSON, or UML (diagram) format. You can see our live docs here: https://s3.amazonaws.com/apidocs.ortussolutions.com/docbox/5.0.0/index.html

💻 System Requirements

• BoxLang 1.8+

• Lucee 5+ / Adobe ColdFusion 2023+ (CFML Support)

🔢 Versioning

DocBox is maintained under the guidelines as much as possible. Releases will be numbered in the following format:

And constructed with the following guidelines:

• Breaking backward compatibility bumps the major (and resets the minor and patch)

• New additions without breaking backward compatibility bumps the minor (and resets the patch)

• Bug fixes and misc changes bumps the patch

📄 License

Apache 2 License: ​

🔗 Important Links

• 💻 Code: ​

• 🐛 Issues:

• 💬 Community:

💼 Professional Open Source

DocBox is professional open source software backed by offering services like:

• 🛠️ Custom Development

• 🎯 Professional Support & Mentoring

• 📖 Training

HONOR GOES TO GOD ABOVE ALL

Because of His grace, this project exists. If you don't like this, don't read it; it's not for you.

"Therefore being justified by faith, we have peace with God through our Lord Jesus Christ: By whom also we have access by faith into this grace wherein we stand, and rejoice in hope of the glory of God." Romans 5:5

🤝 There are several ways you can help in the development of DocBox!

• 🔧

• 🐛 Submit a bug or feature request to our

🎉 Major Release - BoxLang Support & Modern UI Overhaul

BREAKING CHANGES

• Minimum CFML engine requirements updated:

  • Lucee 5.x minimum (dropped Lucee 4.x)

  • Adobe ColdFusion 2023+ (dropped ACF 2016, 2018, 2021)

• HTML output now uses Bootstrap 5 (previously Bootstrap 3)

• Default theme structure reorganized with new Alpine.js-based SPA architecture

NEW - BoxLang Support 🚀

• Full BoxLang 1.0+ Runtime Support - DocBox now runs natively on BoxLang

• BoxLang CLI Module - New boxlang module:docbox command for generating docs from BoxLang CLI

  • boxlang module:docbox --source=/path --mapping=app --output-dir=/docs

NEW - Modern HTML Theme System 🎨

• Two Professional Themes:

  • Default Theme - Modern Alpine.js SPA with client-side routing and dynamic filtering

  • Frames Theme - Traditional frameset-based layout with Bootstrap 5

NEW - Enhanced UI/UX Features 💎

• Modern Color Scheme - Purple gradient accents (#5e72e4), softer colors, reduced blue overload

• Visual Indicators - Emoji badges throughout:

  • 📚 Packages, 📁 Folders, 🔌 Interfaces, 📦 Classes

NEW - Complete Relationship Documentation 📊

• All Known Implementing Classes - Interfaces now show all classes that implement them

• All Known Subclasses/Subinterfaces - Display complete inheritance hierarchy

• Fixed Inheritance Queries - Properly handles both current class and ancestor interfaces

NEW - Developer Experience Improvements 🛠️

• Enhanced JavaDoc Support - Comprehensive documentation with <br> tags for BoxLang compatibility

• 50+ Updated Code Examples - All strategy files updated with proper line breaks

• Improved Error Messages - Better validation and user-friendly CLI output

NEW - Strategy Enhancements 📝

• CommandBox Strategy - Enhanced CLI command documentation with namespace support

• JSON Strategy - Machine-readable JSON with hierarchical package structure

• XMI/UML Strategy - Enhanced property inference and generic type support

IMPROVED

• Build System - Updated build process with BoxLang support

• Testing - Multi-engine testing (Lucee 5/6, Adobe 2023/2025, BoxLang 1.0/BE)

• Documentation - Comprehensive updates for all new features

FIXED

• Metadata Format Handling - getImplements() now properly handles both array and struct formats

• Interface Implementation Display - Fixed empty queries for implementing classes

• Package Navigation - Improved CSS styling for better UX

TECHNICAL DETAILS

• Bootstrap 5.3.2 - Modern component syntax and data-bs-* attributes

• Bootstrap Icons 1.11.2 - Comprehensive icon set for UI elements

• Alpine.js - Lightweight reactive framework for SPA theme

MIGRATION NOTES

From 4.x to 5.0

1. Minimum Requirements: Ensure you're running Lucee 5+, Adobe 2018+, or BoxLang 1.0+

2. HTML Output: The default theme now uses Bootstrap 5. If you have custom CSS, review for compatibility

3. Theme Selection: Explicitly set theme="frames" if you prefer the traditional frameset layout

Updating HTML Customizations

If you extended the HTML strategy:

• Update Bootstrap 3 classes to Bootstrap 5 equivalents

• Review custom CSS for CSS custom property compatibility

• Test dark mode if you have custom themes

UPGRADE INSTRUCTIONS

COMMUNITY

• GitHub Issues: https://github.com/Ortus-Solutions/DocBox/issues

• Documentation: https://docbox.ortusbooks.com

• Community Forum: https://community.ortussolutions.com