Rename config option to resolve deprecation in latest jekyll

Deprecation: The 'pygments' configuration option has been renamed to 'highlighter'. Please update
your config file accordingly...
Add a link to user FAQ

Would help with discoverability and cases like LightTable/LightTable#1693.
Instructions on running docs locally