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

Closes #1569, #1567, #1493, and #1469
Honestly, it screwed up the bracket matching in vim 😛  I'll change it back though