commenting the new code... more fixmes
updated md files