add some rationale for markup choices into README