split README into sub components for doucmentatiion purposes
adding further documentation