extended readme and code documentation