New API documentation
Steve finished updating the new API documentation. This MR removes the current documentation, leaving a link to where the new documentation can be viewed.
To update the API documentation contributors will need to update
I'm not sure what the impact of changing the name of that file is so that it is a better name that more clearly reflects that it is the file to be updated with changes.
- Final review for consistency between old and new docs