Convert the README to rst

[ghost]

I found it a little hard to read the README on github, so I converted it to reStructuredText.

I also fixed some spelling and grammar.

[carlosmunoz]

Thanks for the pull request Christopher. This looks good to me.

@definite Could you please review this and merge if you agree?

[seanf]

In the rendered preview, all the command samples ("code") seem to be in <blockquote><code> which is a little odd.

[seanf]

@cjbayliss Perhaps the indented code doesn't need to be surrounded with "``"? (Not sure of my RST, but I'm assuming it's somewhat similar to markdown in this respect.)

[seanf]

I think what I suggested above will work, if the preceding paragraphs end in two colons, like this::

http://sphinx-doc.org/rest.html#source-code

[ghost]

Yep, that works better, I'll make the change now.

[seanf]

Anyone wanting to see the preview, see here: https://github.com/cjbayliss/zanata-python-client/blob/master/README.rst

[seanf]

@definite Are you happy with the changes?

[seanf]

I generally prefer markdown to RST, but RST probably makes sense for a Python project, and it wouldn't be difficult to convert the formatting from .rst to .md if we need to.

[ghost]

Yep. I should learn markdown, I just do RST because that is what we use at Cyber IT Solutions. :)

[seanf]

Looks like the .. Note:: rendering is being messed up by this: github/markup#68

I think we'll just have to live with it.

[definite]

The rest looks fine to me.

[ghost]

I have made that change, I don't know if there are more like that because I don't use Zanata myself. It is probably worth getting someone to got through this README and fix up that sort of stuff. I only converted the README from what it was to rst. :)

[seanf]

Thanks for the contribution, @cjbayliss .

[ghost]

No problem! :)