doc: some more meat to the readme file...