DEV-47 | review and update docs

Details: https://issues.teracy.org/browse/DEV-47