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

Closes #1569, #1567, #1493, and #1469
Can you add a test for a situation where the type and description would be different? (e.g. `[foo](bar)`)