readme details and proposal pdf