final adjustments to .md files