ForgeRock welcomes David Goldsmith

ForgeRock Logo Welcome to David Goldsmith who joins the ForgeRock documentation team today. Delighted that you have come to work with us at ForgeRock, David!

If you got identity and access management software training before ForgeRock, David’s name might already be familiar to you. David goes way back with identity management, having designed, developed and delivered training for identity management product lines at Sun Microsystems and at Oracle. He comes to ForgeRock from Cloudera, where he also got to know Hadoop very well. As a hands-on, technical curriculum developer, David has strong experience getting his ideas across in the classroom, in training labs, and in writing.

A while ago I wrote, “We aspire … to share understanding with developers and partners like you.” David can definitely deliver on that aspiration. His work promises to be a big win for the community.

Leave a comment

Filed under Docs

ForgeRock doc tools 2.1.3 released

ForgeRock doc tools 2.1.3 is now available.

This is a minor maintenance release, mainly of the default branding.

As mentioned in the release notes, this release brings one improvement and two bug fixes:

  • DOCS-72: Improve widow and orphan control in PDF
    You can now use the processing instruction <?hard-pagebreak?> between block elements to force an unconditional page break in PDF (and RTF) output. The processing instruction has no effect on HTML output.
  • DOCS-162: <replaceable> tags within <screen> tags have no effect in the HTML
    The <replaceable> text now shows up in bold+italic font.
  • DOCS-173: Link text too dark in top-right banner showing latest release

No configuration changes are required, except to update the version number in your POM. See the README for more about how to use the doc tools.

Leave a comment

Filed under Docs, Tools

ForgeRock doc tools 2.1.2 released

Thanks to Gene Hirayama and Laszlo Hordos for their contributions, and to Lana Frost for testing. ForgeRock doc tools 2.1.2 is now available.

This is a maintenance release of the Maven doc build plugin, the default branding, and the common content. No configuration changes are required, except to update the version number in your POM. In order to benefit from improvements to the PDF cover pages, however, you will want to add logos and update the authors list to include a corporate author.

For details about fixes, enhancements, and known issues in the doc tools, see the release notes.

Leave a comment

Filed under Docs, Tools

ForgeRock doc tools 2.1.0 released

ForgeRock community logo Today we released ForgeRock doc tools 2.1.0. This maintenance release includes a couple of new features, a few improvements, and some bug fixes. See the release notes for details.

As described on the ForgeRock developer community Wiki, the Maven doc build plugin relies on a lot of great open source technologies to generate output. A little bit below the tip of the iceberg, we stand on the shoulders of these giants:

Big thanks to all the maintainers of these tools, and to all the people answering questions on their mailing lists. Recursive thanks to all the giants holding up these projects, too. :-)

When you upgrade to use the latest plugin, also take these compatibility changes into account:

  • Add a <projectVersion> setting to your configuration when executing forgerock-doc-maven-plugin (required)
  • Update <screen> examples to use continuation characters when folding user input lines, and make use of <userinput> and <computeroutput> markup (optional). Here’s an example:
    $ <userinput>ldapsearch \
     --baseDN "" \
     --searchScope base \
     --port 1389 \
     "(objectclass=*)" supportedExtension</userinput>

1 Comment

Filed under Docs, Tools

ForgeRock welcomes Gene Hirayama

ForgeRock Logo Welcome to Gene Hirayama who joined the ForgeRock documentation team today. Happy you have joined us, Gene!

Gene has been writing directory and identity management documentation since he joined Sun Microsystems in 2006, and more recently at UnboundID Corp. Gene has worked as a technical writer for 17 years, before that maintaining and monitoring computer systems. Gene’s domain knowledge not only of UNIX and LDAP but also of REST, SCIM, XACML, and OAuth 2.0 will help him quickly to write useful documentation on all components of the ForgeRock stack.

Gene’s initial focus at ForgeRock will be access management documentation for OpenAM, policy agents, and OpenIG. This is good news for ForgeRock and good news for the community, as Gene ramps up in the new year to fix, improve, and extend core documentation.


Filed under Access Management, Docs

ForgeRock doc tools 2.0.0 released

ForgeRock Community Logo Today marked the release of ForgeRock doc tools 2.0.0. This release includes changes for 32 issues. Some were bug fixes, others issues and improvements, still others investigations into a future reimplementation of

You can read the release announcement sent to the docs list. You might also want to read the HTML version of the release notes. Some new features and improvements:

  • Integrated support for text-based UML image sources, thanks to PlantUML
  • Support for olinks in PDF
  • DPI set automatically on PNGs
  • ↪ on mouseover in HTML for all titles with anchors, making it easier to send the link to a procedure, example, or table
  • Support for Maven properties in XML attribute values
  • Branding and common content moved to separate Maven projects, enabling use of custom branding and boilerplate
  • Support for a basic .zip of release docs

When you upgrade to this version of the plugin, you must not only change the version number in your POM, but also adjust the configuration. After you read the release notes, also see the README for more information.

Leave a comment

Filed under Docs, Tools

Rockbox rescued my Sansa Clip Zip

Rockbox logo Let me confess up front. I am typing this on a Mac, not a Linux box. What put me on the slippery slope a few years ago was GarageBand. I tried it on my wife’s laptop. Surely Linux-based recording software has advanced since then, but at the time recording simple tunes with the Mac was far easier. Recording on Linux left me thinking, “Yeah, this would probably be fantastic if I were a recording engineer already and/or was more interested in the software than in writing a few songs.”

We tend to prefer open source software as long as we can still do what we set out to do. At work we build a lot of open source software using mostly open source software. There are, however, cases where closed software is more expedient… for now.

On the other end of the spectrum, there’s the Sansa Clip Zip. This is a case where the decision has gone in favor of proprietary software even though the free software alternative actually works better!

In the beginning I had an iPod Shuffle. A bit overpriced for 2 GB, but good when running or skiing, nice integration with iTunes, and Apple has replaced them without comment when they break down. (I’m on my third, having paid for the first. Don’t their testers go running when it rains?)

But I’m tired of loading and unloading stuff on the Shuffle, due to the lack of capacity. So I bought a microSD card. I loaded most of my music in iTunes onto the microSD card, and put it in an Android phone. The phone choked. It flashed low memory when booted with the microSD card. Then it ground gradually to a halt.

I saw the Sansa Clip Zip. I hoped the Sansa Clip Zip could handle the music, since after all it is a dedicated device. I bought it thinking, “So I can get this for less than $50 and it has a microSD slot. Or I can spend hundreds to get enough capacity on a fragile device that is probably no better for what I want to do.”

The Sansa Clip Zip is a dedicated device, all right. Yet with the original firmware it also chokes on the microSD card full of music. Furthermore, I could not find a log file or other indication of what exactly it chokes on. Anyone want to add 32 GB of music one file at a time, rebooting and reloading the device database after every file? Not me.

I thought maybe it was the microSD card. Now I have two microSD cards… both full of music and both causing the same symptoms on the Android phone and also on the Sansa Clip Zip with original firmware.

Rockbox on Sansa Clip Zip Then I came across Rockbox, Free Music Player Firmware, which installed fine onto the Sansa Clip Zip. It looks like it could be uninstalled, too, with roll back to the original firmware.

After installing Rockbox, I inserted the microSD card, and rebuilt the database…

…and it just works. I have not checked every single song, but they all seem to be there.

Rockbox rescued my Sansa Clip Zip.

There has to be somebody at SanDisk or a SanDisk contractor who is paid to maintain the Sansa firmware. On the surface, their firmware does look different from Rockbox. I would not consider it the next Android or iOS, though. Maybe some people would say it is more intuitive. But it’s broken. Who cares how intuitive it is if you would have to set aside a few days of your life just to figure out which half of your iTunes music collection it can load?

How bad would it be for SanDisk if instead of maintaining their own firmware, they contributed to Rockbox?


Filed under Music