Move /** @scope */ comments inline to their extend calls

Fixes weirdness in the docs where the following piece of documentation
will be prefixed with /**
Merge pull request #2688 from jorygraham/documentation-oddness

Move /** @scope */ comments up a line