Expand README.markdown

[re #15092]