readme and contributing files updated with more info