Make the Markdown into restructured text.
Mention our documentation as well
Make the shell be in code blocks and add a section about building the documentation.