search

eclipse / microprofile-open-api

Microprofile open api
Apache License 2.0
131 stars 81 forks source link

Update references to JAX-RS #527

Closed Azquelt closed 1 year ago

Azquelt commented 2 years ago

Since 3.0, MP OpenAPI depends on Jakarta EE 9, so should all the references to JAX-RS be changed to instead reference Jakarta RESTful Web Services?

MikeEdgar commented 2 years ago

I think this would be good to do.

Emily-Jiang commented 2 years ago

I asked JAX-RS team and they did not think JAX-RS shortname is out of date. They have not made any decision regarding the new acronyme, maybe Jakarta REST. I suggest not to update this as one of the argument is that JAX-RS was such a well-known name and it might hurt the spec if the name was updated to something else. Let's revisit this in the due course.

MikeEdgar commented 1 year ago

We discussed this issue in the Jan 23, 2023 team call and it was decided that the use of JAX-RS should remain used in the spec, but that it should initially be referred to as Jakarta REST with a JAX-RS abbreviation used thereafter.

@Emily-Jiang, please replay if that is an issue.

Azquelt commented 1 year ago

The full spec name is "Jakarta RESTful Web Services", I think we should use that at least once and then we can abbreviate it.