Hello there, 
I am working on a Spring Boot project that has a rather complex API schema, and I am trying to get my Swagger documentation to display correctly. I am using springdoc-openapi for the first time; so I am still learning my way around it.
I have read through some of the documentation; but I am running into a few issues with getting the annotations just right; and I thought I would reach out here for some guidance.
my API responses often include nested objects, lists, and sometimes maps. I am struggling with how to correctly annotate these so that Swaggers output is both accurate and readable.
Also; I have noticed that some fields in the Swagger UI appear out of order compared to what I specified in my code. Is there a recommended way to control field ordering in Swagger annotations? 
Also, I have gone through this post; https://forum.springdoc.cn/t/tableau/5163 which definitely helped me out a lot.
Finally; if anyone has tips on making descriptions more readable for complex responses, that would be really helpful too.
Thanks in advance for your help and assistance. 