DOC: Updated docs based on devteam feedback