SharedMethod: add flag `documented`

The flag is `true` by default and controls whether the method should
be included in swagger descriptor generated by loopback-explorer.
Merge pull request #133 from strongloop/feature/remote-method-flag-documented

SharedMethod: add flag `documented`