[REST] adding basic documentation

---
thanks for improving the grammar.
#5326 is mostly not yet merged