Join me for an exciting adventure through static site generation and large-scale developer documentation. See how far this technology has come by comparing live examples of technical documentation created through static site generation technology from the years 2012 and 2021, both sites generated from the exact same public API spec. We'll pick apart the new sample and discuss challenges, trade-offs, and more! On this quest, our companions shall be JavaScript and Python with quirky sidekicks Stone, Pyxl, and GatsbyJS.

Dropbox has large, outdated developer documentation that is automatically generated (https://www.dropbox.com/developers/documentation/http/documentation). I rebuilt it using GatsbyJS. The system consumes the same API spec, but generates a significantly better site , with substantial improvements to performance, accessibility, and SEO. Live version available here: https://taylorkrusen.github.io/cupcake-docs/