Docs website migration to custom, open source CMS
EngineeringMarch 2021
Engineer on cross functional initiative to migrate the documentation CMS from Drupal to an open source, content-as-code repo to provide developer and external contributor friendly contribution.
The Challenge
We had to migrate and convert content in HTML to React based MDX components and maintain SEO and routing. We also had to completely rebuild internationalization and integrate complex translation vendor API and workflows into the repo. We had to ensure several data endpoints were preserved for downstream services / features that relied on docs data.
Approach
Incremental migration. Used GitHub (and GitHub Actions) and Gatsby as our site generator with content stored in markdown and MDX files.
Outcome
We reduced COGS by $43k / year by removing need for hosting platform.
Technologies
GatsbyNode.jsReactMDXmarkdownGitHubGitHub Actions