Date: September 17, 2021
Event: tcworld China conference
Speaker: Diana Lakatos, Director of Documentation at platformOS

Based on the success of my presentation at the Evolution of TC 2021 conference, tcworld China invited me to talk about the Docs as Code workflow we built for our developer portal and answer questions from the audience about the topic.

tcworld organized the seventh international conference for technical communicators and language professionals in China. Their primary goal is to bring together national and international leaders and professionals as well as friends and partners of technical communication in an open dialogue, to exchange brilliant ideas, to develop solutions for specific TC challenges.

At tcworld China 2021, local and international TC experts shared their experiences and best practices with solutions for China-specific challenges, to exchange the latest information in the Technical Communication industry. Participants had the opportunity to participate in presentations, workshops, and interactive sessions.

The main conference topics covered:

• Intelligent information
• Localization
• Information development
• Software documentation
• User assistance
• Content marketing
• Regulations and standards

I presented a case study of the platformOS documentation and related Docs as Code workflows and processes. This is a summary of what I talked about:

• Introduction: to put everything in context, I started with introducing our team, our community, and the documentation site itself.
• Docs as code: what does it mean, what are the reasons for following a Docs as Code approach and what are the key goals for an organization implementing it. This was a theoretical overview of Docs as Code in preparation for the examples and the more in-depth explanations that followed.
• Content: how we produce and structure content, including how we help others to contribute content to our documentation. We presented examples of our style guide, contributor guide, and templates. We also discussed why we chose the Markdown format and how we use it.
• Editorial workflow: I described the steps in our editorial workflow in detail, including how we use GitHub, how we track issues, and how the review process works.
• CI/CD: finally, I discussed what continuous integration and continuous delivery mean and how each concept applies to documentation, with examples of how we built our CI/CD workflow with GitHub Actions, and how we run automated tests as part of our CI/CD workflow.

If you have registered for the tcworld China conference, you can download the presentation and watch the recording of my talk.