I didnt want to add an md file when the readme is in rst.
Is there a reason why you chose to work on rst ( given that it has a strange syntax for a markup language)
RST is different from markdown, and you have learned markdown first, so perhaps that is why you consider it strange ;-). I agree the links are more intuitive in markdown.
RST is more powerful, and the language used in sphinx and (often?) python docstrings.
One feature I like in particular for README.rst files is that you can have a table of content created (which is not supported by markdown).
I am all in favour of sticking to RST. I think I have fixed most of this file already?
This is an RST file (not markdown).
I didnt want to add an md file when the readme is in rst. Is there a reason why you chose to work on rst ( given that it has a strange syntax for a markup language)
RST is different from markdown, and you have learned markdown first, so perhaps that is why you consider it strange ;-). I agree the links are more intuitive in markdown.
RST is more powerful, and the language used in sphinx and (often?) python docstrings.
One feature I like in particular for README.rst files is that you can have a table of content created (which is not supported by markdown).
I am all in favour of sticking to RST. I think I have fixed most of this file already?