Added README and some clarification points/questions to files