Lcg/1726

closes #1726 

rebase and md files