Update docs in using_doctr

[odulcy-mindee]

This PR aims to:

• modify dead links from the documentation in https://mindee.github.io/doctr/using_doctr/using_models.html such as https://mindee.github.io/doctr/using_doctr/models.html#doctr.models.detection.linknet_resnet18.
• add db_resnet50_rotation and linknet_resnet18_rotation in https://mindee.github.io/doctr/modules/models.html
• update one code block with 4 spaces

[odulcy-mindee]

I needed to set here full path otherwise sphinx can't find this function due to this code:

doctr/doctr/models/detection/differentiable_binarization/__init__.py

Lines 3 to 6 in 739943a

	if is_tf_available():
	from .tensorflow import *
	elif is_torch_available():
	from .pytorch import * # type: ignore[misc]

[frgfm]

Perhaps we should remove this for now then?

So far, we've been using tabs to have usage examples in PyTorch & TensorFlow, but we haven't yet planned to have seperate builds for pytorch and tensorflow (namely because we try to document high level features that have the same input & output signatures)

What do you think? :)

[odulcy-mindee]

@frgfm If possible, the db_resnet50_rotation should be deployed on Tensorflow as well to stick with our high level features vision, but I don't know if it requires a lot a work. :-/

Maybe we can move this line in a dedicated section in which some models are only available in one framework (I'm not aware if it's the case for other models). Then we can reintegrate it when the model is available on both framework 🤔

[charlesmindee]

Thanks, LGTM

[frgfm]

Thanks for the PR @odulcy-mindee 🙏

Quick note @charlesmindee @odulcy-mindee : about documentation modifications, we need to build it locally and try the changes. In this case, the PR breaks a lot of hyperlinks :/

[frgfm]

Perhaps we should remove this for now then?

So far, we've been using tabs to have usage examples in PyTorch & TensorFlow, but we haven't yet planned to have seperate builds for pytorch and tensorflow (namely because we try to document high level features that have the same input & output signatures)

What do you think? :)

[odulcy-mindee]

@frgfm @charlesmindee I think something went wrong on GitHub page deployment. It seems that it has not been updated because links are still broken.

I tested it locally before and here is the output:

You can see that there is a light blue background on each hyperlink on the screenshot. This is due to :py:meth:. This is not the case on the public docs:

Moreover, I added doctr.models.detection.linknet_resnet18_rotation and doctr.models.detection.differentiable_binarization.pytorch.db_resnet50_rotation in doctr.models in Package reference and there are still not present on public docs.

Also, I just noticed that Choose a ready to use dataset and Share your model with the community pages are not published. Is it expected ?

I'll check why it has not been correctly deployed.

[frgfm]

@odulcy-mindee my apologies, I selected the wrong version!
I realized this seeing your comment that the changes hadn't taken effect

By default, the documentation leads you to the last stable release. So to get the latest build, you need to select "latest", and now this works :)
https://mindee.github.io/doctr/latest/using_doctr/using_models.html

All good then!

[odulcy-mindee]

@frgfm Oh cool ! Thanks for the tip haha ! 😅