DOC Add datasets section to website

[jovan-stojanovic]

Fix #621

[Vincent-Maladiere]

Nice

[GaelVaroquaux]

It looks to me like we are duplicating the API page. I would rather that we point to it rather than establish a second list, as this list will be hard to keep up to date.

[jovan-stojanovic]

I managed to link the dataset and the API page, so now the API content is generated from the datasets.rst file.

[GaelVaroquaux]

But why do that? It adds complexity to the API page.

I would rather we don't change the API page, and just do a very small page on the datasets in the narrative docs that points to the API page. The datasets are not a core user-facing aspect of skrub. They are there to enable us to do good examples. They don't need to be prominent in the doc

[jovan-stojanovic]

The idea was to list all functions in both the API and datasets file while not duplicating them explicitly.

I understand the complexity it adds and that duplicating is not the best option.
Here is a very simple alternative version where I only provide a link to the API page.

[GaelVaroquaux]

I don't really like that we are dedicating a top-level header to something which is actually a fairly minor feature of skrub.

I think that it is fine for now, but in the long run, as we add other somewhat "misc" sections, we should fold this section into a subsection.

[jovan-stojanovic]

This was resolved in the meantime by another PR, closing this one..