add installation instructions
make github pages urls match those in development
validate links
fix bad links