[mkdocs] - explore how to move away from multiple .html files to just one .md file per page

We should move away from having .html files as the files that you edit to make changes to the docs. Ideally to edit the docs you'd edit a .md file and everything for a specific page is in the one .md file.

Having multiple html files for one page like we have in our existing docs, makes it challenging to create new content and edit existing content. 