RST rendering on github

[dkirkby]

Environment variables in the tutorial page render on github as:

:envvar:`DESISURVEY_OUTPUT`

This might be a limitation of the github RST engine, but I believe that github is the only place someone might read this page. Assigning to @weaverba137 since he did the md->rst conversion.

[weaverba137]

The when tutorial page appears on Read the Docs, the Sphinx rst formatting will be appropriate.

Note that the tutorial is included in the index.rst file.

[sbailey]

In practice it isn't yet on readthedocs and we tend to link to github a lot anyway, so writing our rst in a way that looks good on github is still useful.

Is there any significant difference to using :envvar:DESI_OUTPUT vs. just DESI_OUTPUT or it it mainly a matter of formatting purity?

[dkirkby]

I see desisurvey on readthedocs but not surveysim.

[weaverba137]

I was going to set it up soon.

[weaverba137]

Can I ask for just a teensy bit of patience here? The file is written in a way that is appropriate to Sphinx + Read the Docs. That is a good thing!

[dkirkby]

Its not urgent, thanks.

[weaverba137]

http://surveysim.readthedocs.io/en/latest/tutorial.html is now active, though it also needs some minor fixes similar to desisurvey.

[weaverba137]

Addressed by #51.