scope: improve description of shared methods

The description is used by client SDK code-generators like
loopback-angularjs.