Get rid of recommonmark dependency

[achiefa]

This PR addresses #1978.

[RoyStegeman]

Thanks a lot for starting this! Don't forget to also delete the markdown file you're replacing.

[achiefa]

Don't forget to also delete the markdown file you're replacing.

Yes, I was't sure whether I should've deleted them or not. I was waiting for your feedback, many thanks!

[achiefa]

I'm currently working on this PR. I just want to mention that nested inline markups are currently not possible in reStructuredText, as explained here. There are some workarounds, but they are really ugly and are not worth the effort. Also, the documentation discourages to adopt them. This just to say that, in converting md to rst, I'm not using nested inline markups when dealing with cross-references.

[RoyStegeman]

thanks, it's a bit ugly anyway so that's fine.

[achiefa]

Just to make a note on the last commit (the one addressing the old grids.md). I've converted it to rst, but I think it is outdated.

[achiefa]

Ok, I think I'm done. Please, @RoyStegeman and @scarlehoff could you please check that I didn't forget anything?

[RoyStegeman]

Thanks! I'll have a look next week.

[RoyStegeman]

Could you also remove it from the dependencies?

[achiefa]

I only see dependencies on recommonmark in pyproject.toml and in meta.yaml in the conda-recipe. Should I just remove any recommonmark key from these files?

[RoyStegeman]

Yes exactly, I suspect you will also have to remove the recommonmark settings from some config file if you haven't already.

[achiefa]

Ok, the doc compiles even after that. Here you can find the log of the build (both stdout and stderr).
build.log

[RoyStegeman]

Thanks, looks good!

At some point we should also take care of the (important) warning such as non-existent labels #1360