translating rest controllers docs to english, related to #386

please review the content and my english :-)