BACKLOG-5262: add doc to handle some new props