This article describes a recent bug in Facebook's Docusaurus project. I was not the first to discover this bug, nor was I the one to ultimately fix it, but it makes for a very interesting deep dive into how to triage and resolve an issue.
Welcome to the first in running series of articles titled Bits of Bad Code! I've always found failure to be a powerful learning mechanism. The ability to learn from the failure of others is an important part of that. This article series stems from a habit a built up with some of my teams to share example of bad code we've found and talk about why they are bad and how to make them better. This has been a fun experience for a my teams and a wonderful learning experience for growing software engineers. The goal of this series is to share similar examples of bad code and talk about how to make them better.