[REST] adding basic documentation

---
thanks for improving the grammar.
I can't find that option in my codebase, was it forgotten?