Lcg/1561

closes #1561 rebase and md files.