BF: include demos fully

also change README to reST :(