* updating docs to make things a bit more clear * fixing broken links * more broken links * fixing broken links * website updates * PR review changes * fixing bad links