Blog

CommandBox 5.3.1 Released

Brad Wood |  May 18, 2021

We've released a small update to our recent CommandBox 5.3.0 release.  This contains fixes for a handful of regressions as well as a couple new features.  You can access the new version on our Download page, our deb/rpm repos, or Homebrew.  

And of course, you can find the latest docs  and release notes here:

https://commandbox.ortusbooks.com/

Read More

cbValidation v3.1.0 Released

Luis Majano |  May 17, 2021

I am so excited to bring you the release of cbValidation to version 3.1.0. This has been a great collaboration between Wil De Bruin and Eric Peterson. Thanks so much guys for all that you do for open source. You can see all of the release notes below with some of the major improvements of this release. To get this release make sure you are already on version 3.x and use CommandBox: box update cbvalidation. You can find the release notes here: https://coldbox-validation.ortusbooks.com/intro/release-history/whats-new-with-3.1.0 and you can view all the new documentation here: https://coldbox-validation.ortusbooks.com. Enjoy!

Read More

Brad Wood

May 13, 2021

Spread the word


Share your thoughts

Our friends at TeraTech help put together a comprehensive survey of the entire CFML community to get a feel for how it's evolving, what new technologies are getting picked up, and what the current pain points are.  We use this data at Ortus to help us decide what CF engines to support and how to help the community.

Here's an example question from the survey that tracks the most popular versions of Adobe ColdFusion and Lucee Server:

https://teratech.com/state-of-the-cf-union-2021-survey

If you haven't taken the State of the CF Union 2021 Survey yet, please do so and pass it on to all your coworkers and friends who may not be on social media themselves.  The more responses we get, the better data we have.  And make sure you remember to check all the Ortus products you are using while you're taking it!

New Object-Oriented Programming Series to Debut on CFCasts

Paulina Lainez |  April 29, 2021

This week we debuted our first-ever Object-Oriented Programming Series in our CFML learning platform, CFCasts.

Read More

CommandBox 5.3.0 Released

Brad Wood |  April 28, 2021

We are pleased to announce the general availability of our latest CommandBox CLI release. This is a minor release that's full of bug fixes and enhancements.  It should be backwards compatible (with one caveat below) and you can upgrade any previous version of CommandBox in-place to the latest release.

Read More

ColdBox 6.4.0 Released - Welcome to the land of Scheduled Tasks

Luis Majano |  April 20, 2021

 

Today we released ColdBox v6.4.0 but it feels more like a major release than a minor one. We are introducing tons of new features in this release, especially our anticipated: ColdBox Scheduled Tasks feature set.

update coldbox

# If you are using standalone libraries, then update those
update wirebox
update cachebox
update logbox

You can find our what's new document here: https://coldbox.ortusbooks.com/intro/release-history/whats-new-with-6.4.0. So let's explore some of the major features of this release and then on to our release notes.

Read More

ColdBox Debugger Mini-APM v3 Launched!

Luis Majano |  April 07, 2021

We are so excited to bring about a major release for the ColdBox Debugger project: v3.0.0. However, what in the world is the ColdBox Debugger module? I am glad you asked:

What is the ColdBox Debugger?

The ColdBox Debugger module is a lightweight performance monitor and profiling tool for ColdBox applications. It can generate a nice debugging panel on every rendered page or a dedicated visualizer to make your ColdBox application development nicer, funner and greater! Yes, funner is a word!

Debugger Request Visualizer

Read More

CommandBox Docker v3.3.0 Images Released

Jon Clausen |  March 24, 2021

Today we are pleased to announce the release of version 3.3.0 of our CommandBox Docker images. This release contains a number of enhancements for multi-architecture support, Adobe Coldfusion 2021 compatibility, and security.

Of note, and a potentially breaking change for some, is that the base ortussolutions/commandbox:latest tag is now based on OpenJDK11 rather than OpenJDK8. Those who require the Use of JDK8 should pin their builds to the ortussolutions/commandbox:jdk8 tag. This decision was made because there is now only one JDK8 image that is currently being built - :adobe2016 .

This version also adds support for Adobe Coldfusion 20201 Package Control Manager with new environment variable support.

Best of all, we are now publishing multi-architecture builds. All of the base tags are now available in both amd64 and arm64 architecture - the latter, which is used increasingly on AWS and Apple's M1 processors. This opens up the door for additional architectures, in the future, including Windows.

Read More

DocBox 3.0 Released

Michael Born March 15, 2021

Spread the word

Michael Born

March 15, 2021

Spread the word


Share your thoughts

DocBox

Say hello to DocBox 3.0! This new version adds JSON output format, multiple strategy support, and a raft of improvements across the board. Check it out by running box install docbox@3 to install the new version.

What Is DocBox?

DocBox is a CFML library that converts CFML component metadata and comment blocks into documentation. You can choose from three documentation formats - HTML, JSON, or an XMI file for generating UML diagrams - and generate docs from the CommandBox CLI or from your application.

In other words, DocBox takes you from code comments to delicious documentation in a matter of minutes.

Why Is DocBox?

DocBox exists to fill the gap between hand-written documentation (such as coldbox.ortusbooks.com ) and no documentation whatsoever. DocBox is especially handy for public libraries, as it makes it simple for consumers to see the available classes and method signatures without needing to manually read or search the source code.

Installing DocBox

There are two main ways to generate app documentation using DocBox:

  1. From the CommandBox CLI, with DocBox Commands
  2. From your CFML app, with the DocBox library

From CommandBox

To use DocBox within CommandBox, you'll want to run install commandbox-docbox and follow that with docbox help to see the available commands and syntax.

Just as an example, here's a typical command to generate documentation for a Coldbox application:

docbox generate source=./ mapping=app excludes=tests|coldbox|testbox|modules strategy-outputDir=./tmp strategy-projectTitle=""

For more examples and documentation, check out the DocBox Commands project on Forgebox.

From Your CFML App

For generating documentation from your CFML application, run install docbox within Commandbox to install the docbox library.

Now you can create a CFML file to instantiate the Docbox class, configure a few settings, and run the documentation generator:

new docbox.DocBox( "HTML", {
        projectTitle : "CommandBox",
        outputDir : expandPath( './docs' )
    } )
    .generate(
       source = expandPath( "/app" ),
       mapping = "app",
       excludes="(coldbox)"
    );

Check out the Docbox documentation for configuration help.

CFCasts Series

Are you interested in using DocBox for your projects? We are working on a "Using DocBox" CFCasts series for those devs who need a bit more help getting started. If you like the idea of automated documentation but don't know where to start, you'll love this new series on CFCasts. Using DocBox will be available in the coming weeks.

Release Notes

3.0.0

Added

  • New json output strategy for machine-readable documentation.
  • New addStrategy() method for generating multiple documentation formats simultaneously.
  • New documentation site hosted at docbox.ortusbooks.com
  • New TestBox suite of tests ensuring CF2018, CF2016 and Lucee compatibility on every output strategy.

Changed

  • Can configure strategy with "alias" name, like strategy="HTML".

Removed

  • Removed HTML as the default strategy. You will need to explicitly pass this to the constructor or to docbox.addStrategy( "HTML", props ) to set your desired output format.

ContentBox v5.0.0 Beta Released

Luis Majano |  March 11, 2021

Today is a majestic day! A day that brings the release of our very first beta for ContentBox 5! This release has been in development for over 6 months and its a major architectural shift from our previous versions; multi-site support. You can now migrate over your Mura CMS applications with ease to ContentBox knowing that multi-tenant support is now available for all, for FREE, FOREVER!

Here is our what's new guide with our full release notes: https://contentbox.ortusbooks.com/intro/release-history/whats-new-with-5.0.0

I will be covering the major features in this introductory blog post.

Read More