document overriding .md file detection
document trailing whitespace