Docs for RelationDefinition

[anodynos]

It's not a bug or a feature request, but a docs request + question:

With regards to app.models.Person.relations with seems to be holding a RelationDefinition instance for each relation name, I am trying to use it for run-time introspection (like its used in many other components or mixins such as this loopback-cascade-delete-mixin but unfortunately I can't find any documentation/reference about it :-/

One would expect relations it to be under https://apidocs.strongloop.com/loopback/#model but it lists only instance methods, not instance members. I've also tried https://github.com/strongloop/loopback-datasource-juggler/blob/master/docs/ but there isn't anything there also.

The question is, are the docs deliberately missing (because developers & component/mixin creators) are not supposed to use it for introspection, or is it just missing because WIP?

Any help is appreciated.
Regards