md -> rst and add explanatory text