Ivadomed: Reference API documentation section in RTD

[charleygros]

Here below a line from docs/source/configuration_file.md where I would link to reference the loss functions documentation in the API:

- `name`: Name of the [loss function Class](https://ivadomed.org/en/latest/api_ref.html#ivadomed-losses).

Is there a better way to do it than passing the https address?

[jcohenadad]

does this work?
~~~

• name: Name of the loss function Class.
  ~~~

EDIT 2020-06-09 10:19:48: i guess it doesn't 😞 https://github.com/readthedocs/recommonmark/issues/8

[Drulex]

does this work?

- `name`: Name of the [loss function Class](api_ref.rst#ivadomed-losses).

It would work if referencing the html as shown below:

- `name`: Name of the [loss function Class](./api_ref.html#ivadomed-losses).
- `name`: Name of the [loss function Class](api_ref.html#ivadomed-losses).

I am currently writing an elaborate answer here

[Drulex]

See this comment explaining how to reference python objects in the doc: https://github.com/ivadomed/ivadomed/issues/280#issuecomment-645452483

To reference files or section of files (labels), the native :ref capability of rst can be used. More info here: https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#ref-role.

Can we close @charleygros ?