Build up the readme and include executable documentation

[ci skip]