Description

Also part of my work as a StackBuilders consultant working at Twilio. Work consisted on migrating the /docs pages to a Docs as Code architecture. To accomplish this we developed a parsing tool using Typescript that would leverage the wagtail CMS REST API to read the page structure and translate it into MDX files that would be rendered on the Next.js frontend. A good chunk of pages had code samples too, so our tool had to handle the code generation for those code samples in multiple languages as well.

Challenges

• Lots of visual QA, migrating a total of 1k+ pages in batches of 60 - 100 pages at a time and having to run through each one to make sure it was rendering correctly and making changes to the tool as issues/edge cases showed up.
• A lot of pages in a lot of places (old legacy PHP pages, some wagtail CMS and some in of random one-off sites)

Lessons

• Organization/Priorization of work. There was a LOT of pages to migrate so we split them by wagtail block usage and prioritized the pages with the most traffic.