first attempt to document core

Ok. If we care more about the markdown files than about the autogenerated doc, then readthedocs makes sense. In that case, I would move all the markdown (except the README, of course) into a ```/doc/``` directory.