[REST] adding basic documentation

---
thanks for improving the grammar.
s/might breaks/might break/