Documentation improvements

* Documented using running pid with /var/run
* Cleaned up production documentation to be nicely linked
* Added external link validator
* Fixed some, but not all, broken external links