Unifying Documentation: A Tale of Two Security Giants
summary
Migrated 48,000 pages in 10 months by running an XSLT conversion script into Docs as Code + Antora and bundling dependencies so writers install once and publish; site runs on GCP + Jenkins pipeline with static buckets, custom JS orchestration and Astro navigation. Traffic doubles after consolidation, redirects roll out after launch, and a GenAI search goes live. Team grows to ~32 writers plus doc tools; the merged site ships and works.
AI-written summary · about
chapters (19)
- 0:00Introduction
- 1:24Ping Identity and speaker
- 3:14Ping Identity’s team growth
- 5:25Merger with ForgeRock challenges
- 7:11Unified documentation methodology
- 7:53Migrating 48k pages in 10 months
- 10:02Rebuilding docs infrastructure
- 13:16Tooling updates and Antora
- 16:49Unifying two teams
- 21:32Results and improvements
- 22:15Closing thoughts and plans
- 26:33Q&A: Stakeholder buy-in
- 27:59Q&A: Security requirements
- 29:04Q&A: Docs as product
- 31:18Q&A: AsciiDoc selection
- 32:19Q&A: Job security concerns
- 34:26Q&A: Phased tool changes
- 35:09Q&A: Supporting teams
- 37:17Q&A: Team distribution
related talks
30mThe Blue Side of Documentation
17mBuilding Secure Open Source Communities From the Ground Up
56mMaking ASVS Truly Your Own
47mWhy keeping your system secure is a bit like decluttering
35mSovereign docs
47mHow to 10X Your Company’s Security (Without a Series D)
34mDevOps Transformations At National Instruments and...
51mTaking AppSec to 11: Pipelines, DevOps and making things better