added README and improved lists