help me organize a documentation feature list?

[aryairani]

Stuff I've noticed in rho:

• route description
• path parameter name
• query parameter name
• result codes
• (somehow) response model for json response
• required headers

Stuff I see in Swagger UI but haven't spotted in rho

• path parameter description
• query parameter description
• required header description

Stuff I can think of but didn't see in Swagger or in rho

• custom reasons for error result codes
• response model with field descriptions for json response (maybe I can help here)

(I haven't read the swagger 2.0 spec)

What am I missing?

[bryce-anderson]

That is a pretty good list of things. Its missing the information about HAL. @before, do you have any suggestions for a HAL feature list?

@refried, rho is currently building models from case class structures based on reflection. I'm not that happy about using reflection, but in this case its pretty convenient. It was based largely on code from the scalatra project here. It could certainly use a refresh especially in the face of swagger-2.0.

[aryairani]

I'll try to take notes this time, since I'm kind of relearning everything.