Fixing an error and refurbishing README files. Adding also the new appendix to the module