fix doc display

This PR fixes the display of the API documentation, it was actually showing the markup on screen rather than the rendered html. I fixed this by naming the files `.html.md` rather than just `md` (now the `.html` is kept in the filename rather than it being removed after parsing the markdown.

Another fix is for the redirect of the old docs page to the new one.