Sigh. After proof-reading 'take 2' several times, and posting it, it has vanished , so now it's 'take 3':
Thanx to daxim for valuable comments on omitting any discussion of the http method names. I've put a new section in the doc, near the front, spelling out what I intend the doc to cover.
And thanx for Aristotle for valuable comments on the phrase RESTful urls. I've wiped out all trace of that phrase, which means even the disk file name has changed.
 I should have expected that, since it almost always happens at weekends, although you'd like it to not happen at all...