++, but only for being concerned and posting a cogent writeup.

But not so as to the substance, that "readmore" is insufficiently emphasized in our docs; that you went looking "...in “Markup in the Monastery” and very nearly couldn’t find it! It is not at the top of the section where you would expect it."

Do you consider exposition and illustration of <readmore>...</readmore> more important than the section on code? on links? on paragraphs?

To paraphrase, you can please some of the Monks, some of the time... and all of the Monks, none of the time.