Improve docs for updating mainstream slugs

Lets keep this documentation closer to the codebase.

Original documentation has been updated to new usage of the higher level fabric tasks, however this rake task can document itself with a link to the main documentation for further info.