Run-through of the first chapter in the docs

I'm happy with the first chapter for 4.0 release.