documentation: Document returned path order for ris

[margau]

Describe the feature
Document the slice order of paths in ris responses.

Use cases / additional context
For every route, the ris does return a list of paths. ris tries to imitate the path selection algorithm of the router, and returns the assumed best path at first. This is not documented properly.