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.

This is a follow-up PR for #131 implementing the requested feature in the right way.

/to @raymondfeng please review
/cc @ritch @shelbys @dashby3000