Fix rst indentation and internal references

[vaitkus]

This PR fixes a few formatting issues that cause warnings when converting the rst file to a pdf using pandoc. Not sure how and if these issues manifested on GitHub since currently I cannot force this file to render here (earlier version of this file also do not render).

Also, the elements_ratios field was misspelt as element_ratios in several places that deal with the metadata properties.

Finally, is there a simple way to make a field name to both link to the corresponding section in the document and be formatted in the same way as other fields (i.e. to combine ":field:elements_ratios" and "elements_rations_")?

[ml-evs]

Thanks for this @vaitkus, fixes look good (will review properly soon). We should add the pandoc converted spec to the CI at some point (see #378 and #482)

Just wanted to raise the issue that I don't seem to be able to preview RST anymore on GitHub... at all... does anyone else have this issue? Even older versions of the spec are not renderable...

[rartino]

The corrections all seem correct to me.

[ml-evs]

Likewise, thanks for spotting these @vaitkus.

[vaitkus]

@ml-evs Is it OK to merge this now or would it be better to wait until the RST rendering issue is resolved?

[ml-evs]

I'll merge now, I think these are clear specification bugs and we can imagine what the rendered docs will look like. Not sure if the resolution will come anytime soon...