Thanks for the feedback jonathan - we're actually working on improving the our auto-generated docs for each resource. You might notice that they don't describe the nested structures as well 😅