Improved docs

[nedbat]

A number of changes to the docs and docstrings, generally skimming through and cleaning up, modernizing, bringing up-to-date with the code, etc.

[nedbat]

@cpennington it would be good to have these on rtfd.org for tomorrow.

@mhoeber Not sure if you want to chime in on any aspect of this, maybe you want to at least see the kind of changes I'm making.

[cpennington]

Not for this PR, but we should use the console_scripts entry point to just install the startnew script into the virtualenv when you install xblocks. That way, in the future, you'll just be able to pip install XBlock && start_xblock, or something similar.

[nedbat]

Why didn't I think of that!!? :)

[cpennington]

👍

[mhoeber]

Thanks @nedbat I'm a little late but if you want me to do specific tasks by datajam, let me know. I have some time this afternoon and evening.

I can also deal with the RTD part. However, edX account currently doesn't have admin for XBlock project.

My goal is that starting in January when Alison starts is that any tasks like this can be assigned to me. We can talk in detail next week

[nedbat]

@mhoeboer thanks. I have the docs on rtfd.org already (XBlock was the first open source from edX). I'm not looking for you to do anything by the datajam, just wanted to get in the habit of keeping you in the loop at least.