Merge pull request #386 from psav/docs_update

Added more documentation
Rejigged provider pages a little