documentation!

In markdown format.  Currently only for C++ executables in vcflib.