In case you missed the Ignite talks at OSCON 2014, Mike Jang presented what it’s like for a tech writer to take over the role of sys admin.
Excellent talk, Mike! Short, sweet, and had me smiling the whole time.
(Somehow we need to work Edvard Munch into the admonition graphics, too.)
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.
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.
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.
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:
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.
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 docs.forgerock.org.
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.