On 3/13/18 1:25 PM, James Blachly wrote:

On Tue, 13 Mar 2018 13:10:58 -0400, Steven Schveighoffer wrote:

I remember reading it in Kai's book.

Going to buy the ebook now...

Definitely worth getting, but if I may quote from his book:

"If the first parameter of a method is named id, then this parameter is
mapped to the void putData(string id, string data); path using the
/:id/data path. This is really a legacy mechanism but you must be aware
of it in order to avoid surprises."

So it seems that this is not really intended as a current "feature", but
supported for legacy reasons. And there aren't any other surprises he
goes over (unless you count parameters with leading underscores, but
that is a useful feature and is in the docs), so I'm pretty sure this is
the only issue you may come across.

It really should be in the docs IMO, especially in the main Rest API
doc. I'll file an issue.