[APIDocs] Missing content from RepositoryMixin

[dhmlau]

Description / Steps to reproduce / Feature proposal

For the RepositoryMixin apidocs section (http://apidocs.loopback.io/@loopback%2frepository/#1798), besides the tsdocs for the class, the rest are missing. For example tsdocs for repository and dataSource functions are missing.

Current Behavior

Only the description for RepositoryMixin class shows up, but nothing for the functions.

Expected Behavior

Should also show the tsdocs (including code examples) for the functions.

See Reporting Issues for more tips on writing good issues

[dhmlau]

The problem is the information is at the level inside the function body, what we can do is to put more information at the top level.

cc @raymondfeng @bajtos

[shimks]

The problem with the docs in repository.mixin.ts is that the order in which the docs introduce {summary, example, params} is wrong. Currently, the docs are written in this order: summary -> params -> example. It should be written in this order: summary -> example -> params. Just switching those should fix the problem (I think). Can someone with enough bandwidth try this?

EDIT: I've been able to verify that this does not fix the docs