Welcome to Shankar Raman, who joins the ForgeRock documentation team today.
Shankar is starting with platform and deployment documentation, where many of you have been asking us to do more.
Shankar comes to the team from curriculum development, having worked for years as an instructor, writer, and course developer at Oracle on everything from the DB, to middleware, to Fusion Applications. Shankar’s understanding of the deployment problem space and what architects and deployers must know to build solutions will help him make your lives, or at least your jobs, a bit easier. Looking forward to that!
This allows browsers to use progressive rendering, and start laying out the page before everything has been loaded and styled. The result is that large documents feel faster in your browser.
If you have bookmarks to published HTML, notice that we have dropped the per-chapter view of published docs. Each document is now a single HTML page. So instead of a link to
/docs/product/version/book/#section. Also notice that we have consolidated documentation sets to make information easier to find, with only one set per major or minor release. Generally this means that you only have to read one set of release notes, no matter what maintenance version you have right now.
The latest docs are the ones for version 5 of the platform:
We still publish all the same docs as before, including docs for software that is beyond the end of its service life. Please check out the updated site. Open issues there for any problems you notice.
Late welcome to Nabil Maynard who joined the ForgeRock documentation team this past Monday.
Nabil has started working on the identity management documentation. He’s digging into his new full-time job as a writer.
Nabil brings solid technical experience and understanding of how server software works, having been a QA professional for years at places like Dropbox. So much of writing good documentation for ForgeRock software depends on throughly understanding what the software does, how it can be broken, and what you should do to make it work correctly. Nabil’s contributions will surely help you get deeper into ForgeRock’s identity management software.
Late welcome to Gina Cariaga who joined the ForgeRock documentation team this spring.
Gina has strong experience writing about access management and directory services. Her formal background in training, mixed with her hands-on success with the kind of documentation we do at ForgeRock make a great combination.
Gina’s initial work at ForgeRock has included putting together a guide to getting started with the ForgeRock platform for IoT architects and developers. Gina is continuing to write on using ForgeRock’s identity and access management capabilities in the IoT space, and much more.
By now you have probably read the news about the ForgeRock Identity Platform 5.0 release.
This major platform update comes with many documentation changes and improvements:
- Access Management docs are now arranged to make it much easier for you to find all the details about new features and specific capabilities (User Self Service, OAuth 2.0, SSO, Authorization, and more). Since long-time readers who know where everything was might find this disconcerting at first, we also included a map to the new doc set. Don’t forget to check out Amster, too, which is new, and lets you do configuration as (file-based) artifacts.
- Identity Management is covered with the same titles as the previous platform update, but a lot of new features that make integration easier. (Integrated social identity provider support, better system connector support, additional audit event handlers, HSM support, etc.)
- Directory Services now has a Security Guide covering all the features for protecting your deployment, a new configuration reference, a bunch of smaller doc improvements, and full coverage of new features (LDAP proxy, native JSON syntax, tools improvements, documented HSM support, and so on).
- Identity Gateway docs now include a Deployment Guide aimed at those of you working in DevOps environments. They also cover all the new features, from the developer Studio to SSO filters and everything in between.
- Platform docs make their first appearance in the update. Try the DevOps examples, which point to a more cloud-friendly way of deploying the platform. And if you are new to ForgeRock software, start with the platform guide that maps the functional modules to the documentation that describes them.
Hope you have no trouble finding what you need.
ForgeRock still has open positions in many locations. One of those is for a writer based in our Vancouver, WA office (across the river from Portland, OR).
Be forewarned. This is challenging, hands-on technical writing and reverse engineering work. If you are looking for a gig where you can remain in your comfort zone, skip this one.
On the other hand, if you feel that most things worth doing are tough in the beginning, take a closer look and apply for the job.
Some of you have been looking for the latest ForgeRock docs.
They are still on BackStage:
OpenAM (latest release: 13.5)
OpenDJ (latest release: 3.5)
OpenIDM (latest release: 4.5)
OpenIG (latest release: 4.5)
Try the BackStage search engine, too. (Top of the page at https://backstage.forgerock.com/docs.)