I'm don't really know much about rst files, I am not really sure if this is an 
issue or not .

Situation

Was searching for on github's website for a error message and came across a 
reference in <https://github.com/nim-lang/Nim/blob/devel/doc/manual.rst> which 
I opened and started to read.

It looks quiet readable and there was nothing to indicate this was not supposed 
to be read by humans, but I was initially confused by the content until I 
realised it was missing lots of code samples which appear in raw mode. It would 
appear from a casual comparison between the code blocks that appear and those 
that don't, is that if a code-block does not have a blank line between the `.. 
code-block:: nim` header and the actual code, then the github viewer does not 
display any of the code block.

The official manual e.g. at <https://nim-lang.org/1.4.4/manual.html> is fine

The manual at <https://nim-doc.readthedocs.io/en/latest/manual.html> is not.

Reply via email to