Writing guides and use cases for various SaaS solutions for a new open-source developer toolkit that audits infrastructure access for various systems. Along with this, we assisted with testing and quality assurance from start to finish.
ConductorOne secures workforce identity in your cloud apps and infrastructure through central access controls and automation. ConductorOne’s open source toolkit (referred to as Baton) allows you to extract, normalize, and interact with workforce identity data such as user accounts, permissions, roles, groups, resources, and more. With Baton, developers can audit infrastructure access on-demand, run diffs, and extract access data. This can automate user access reviews, exports into SIEMs, provide real-time visibility, and many other use cases.
To realize ConductorOne’s vision of securing workforce identity, they needed to be able to connect to any technology, anywhere – and this required a new approach that bridges the protocol divide of the identity and authorization layers provided by apps. They decided to open source Baton to make identity and permission data easily accessible and to create standalone value for security and identity engineers. To introduce the new toolkit to the world, we crafted an array of resources that provide useful guidance on how best to incorporate it into existing processes. With these use cases and guides in hand, developers can be confident they are taking full advantage of this innovative technology.
Working with DX Heroes was smooth and collaborative. They took the time to understand what we were building and why - and they were willing to work alongside us to create detailed guides as we were creating the tools. They were very thoughtful when it came to ensuring the quality of the toolkit and the documentation.
The toolkit was still under development, and we had to adapt to the rapid changes and be able to continuously discover the causes of bugs we encountered while preparing the manuals and writing the code examples. The toolkit can integrate with many SaaS software systems and some of the required ones were unfamiliar to us, so we had to learn the functionality that needed to be delivered for successful documentation delivery in a short time.
%203.png)
We identified the client's needs, and together we agreed on the expected deliverables, their quantity, and timeframe. The requirement was to prepare three tutorials and five use cases that would easily show users the toolkit's capabilities and how to start using it across different services. Iteratively, we prepared the documents for the required services and revised them together to finalize them into a form of excellence that will be published.
As an output, we provided full user documentation along with the writing guidelines. We also supplied suggestions for using graphical and audio-visual elements to increase user understanding. All written guides used the Conductorone style guide and writing rules to maintain the same tone of voice for the brand.
