fix(docs): handle @links & @code, document webdriver's locators, don't run gulp twice

Closes #1569, #1567, #1493, and #1469
Can you add an example of what happens to a link with a description?