converted CAVEAT file content into .md Adjusted headlines and comment syntax to markdown.
trivial: rename the CAVEAT files to .md