SIM-895 update workflow dev docs

To test what the new documentation looks like, cd into the docs directory, and run make html to create a build directory with an html/index.html file, which can be opened in a browser.

I have reorganized the pages. Let me know if you don't like it :)