[REST] adding basic documentation

---
thanks for improving the grammar.