ForgeRock welcomes Chris Lee

ForgeRock Logo Welcome to Chris Lee! Chris joined the ForgeRock documentation team today. Great to have you at ForgeRock, Chris!

Chris comes to us from SN Systems (part of Sony Computer Entertainment Group) where he led the documentation effort for their PlayStation game development tools. He understands what developers are looking for, and is primed to come over to the world of Java and the web. Chris’s previous experience in support and as a website engineer give him a head start understanding the solution space that we address at ForgeRock. And he brings a Microsoft power user’s perspective to our team, which is important for a lot of our readers.

Chris will focus on ForgeRock access management documentation, in particular for OpenAM. This is good news for the ForgeRock access management community.

Leave a comment

Filed under Access Management, Docs

Mike Jang on life as a sys admin

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.)

Leave a comment

Filed under Uncategorized

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:
      <screen>
    $ <userinput>ldapsearch \
     --baseDN "" \
     --searchScope base \
     --port 1389 \
     "(objectclass=*)" supportedExtension</userinput>
    <computeroutput>dn:
    supportedExtension: 1.3.6.1.1.8
    supportedExtension: 1.3.6.1.4.1.26027.1.6.1
    supportedExtension: 1.3.6.1.4.1.26027.1.6.2
    supportedExtension: 1.3.6.1.4.1.26027.1.6.3
    supportedExtension: 1.3.6.1.4.1.4203.1.11.1
    supportedExtension: 1.3.6.1.4.1.4203.1.11.3
    supportedExtension: 1.3.6.1.4.1.1466.20037</computeroutput>
      </screen>
    

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.

2 Comments

Filed under Access Management, Docs