Responses API documentation on structured outputs is lacking

I gave up and stuck with chat completions for much the same reason. I just could not work out how to get the json schema setup right for the responses api. The documentation looks good but then transpires to just be lacking in necessary detail in so many places!