adds some comments on header approach
adds repo metadata