translating rest controllers docs to english, related to #386

please review the content and my english :-)
*customer* list as method parameter