Added link from the migration guide to the CompletionShell page
Added versionadded notice
Rewrite intro
Rewrote some bits