include markdown files

Markdown files for understanding the scripts and variables contained in
the produced dataset