extended readme explanations