clean up docs and deprecation around how to create Props

tickets 3764 and 3823