Improve docs for updating mainstream slugs

Original documentation link removed. Lets keep this documentation closer to the codebase instead and update the original documentation with only what is required.