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

Closes #1569, #1567, #1493, and #1469
Why not just `/{\s*@link\s+([^}]+)\s}/`