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

Closes #1569, #1567, #1493, and #1469
Nit: add spaces after `it`