Converted demo 1 instructions to reStructuredText

[max-sn]

Includes:

• The instructions for demo 1 are converted to reStructuredText
• Instructions are added to fix #322.
• For my build process I also added support for Sphinx versions >=1.4, this shouldn't break anything for lower versions.

[marip8]

I think this looks really good; thanks for putting this together. I have a few minor formatting changes that I would like to add before merging. Would you mind allowing edits by maintainers for this PR (should be a check-box on this page at the bottom right)? It's a little easier for me to push the commit directly on to this branch as opposed to opening a PR against your fork.

[max-sn]

I don't see such a checkbox on this page, could that be because I'm not formally the owner of the fork? (It says here that to enable that it should be a user-owned fork: https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/committing-changes-to-a-pull-request-branch-created-from-a-fork)

[marip8]

No problem. I've attached the commit as a patch below instead. You should be able to apply it to this branch by running the following command on your branch:

git am minor-formatting-changes.patch

minor-formatting-changes.patch.zip

[max-sn]

That's a great feature! Thanks for the changes by the way, some things I noticed already but I was unsure whether I should change them, but other things I completely missed.

[marip8]

Thanks for the contribution and documentation improvement