Migration2

If you could pull this, so we can look at on readthedocs, then that would be great :)

It is my assumption that the edit button and image scaling is handled by RTD.

I gave up on the idea of keeping everything within 80 chars. I've tried to keep most within that limit, but accepted that code lines will extend beyond that. But I still want the actual code part i.e. without indentation and whatever to be below 80 chars, so it follows the style guides when copy pasted. 

Since I was looking over the entire documentation, I also found some phrasing that I thought could be made simpler & clearer. So the scope of this has been expanded a bit.

What needs to be done now is

 * Ensure those two assumptions listed above are true.
 * Implement any changes coming from our discussions of these commits.
 * Making sure updates in version work correctly.
 * Merge the last two squashable commits. The latter is being annoying with git and the first I wanted to emphazise to you. Hmm, maybe it should not be squashed and just be on it's own.