Documentation is never completely seamless. Everyone aims for helpful, efficient, and — of course — consistent content. But with so many content creators and file formats, stuff gets clunky.
At one time, we had that problem with PatternFly documentation. Our HTML/CSS community was writing documentation in a different format than our React community, and maintaining consistency was tricky when trying to create our combined documentation site, patternfly.org.
But we found a way. Here’s how we unified our documentation with MDX.
Frontend build engineer at Red Hat