added in core with the two main functions
added some sections to the readme