link to repo added, diagram added, few improvements