correcting doc in core and adding readme