translating rest controllers docs to english, related to #386

please review the content and my english :-)
I'd highlight / here, just like:

> parameter to include the `/` character.