docs(bike-shed-migration): fix up links outside the domain

It is safer to use markdown style links and save jsdoc style links for
internal links and code references