Originally the docs were written wuith
It could not support a complex use case that was needed to embed multiple code snippets.
This is when
mkdocs was proposed as many other sites use it -- Azure and GCP.
The platform automation team has been using
mkdocs to build our documentation and on Pivotal docs for our beta.
This document is to explain the technical changes, not the product changes of the choice.