-
-
Notifications
You must be signed in to change notification settings - Fork 280
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
v3 introduces some regression if it comes to parameters
description
#979
Comments
Yeah, can be added in v3.1. |
First, i want to say thanks @derberg for catching this 🙌🙌.
I'm completely not sure about this statement to be true. Having said that, I'm not pretty confident about this causing a low impact in case this feature is missing in v3.0.0. Im not blocking but just want to know from you if you have sources to confirm this is a really edge case. |
We have seen similar raised question on slack as well, where people where no longer able to define that the parameter for example should be an integer. |
It's low impact because it's on 2.6.0. I mean, it's not that some people can't continue using AsyncAPI, it's just that they won't be able to adopt 3.0.0, which is ok. They can adopt 3.1.0, which can be released as soon as January 2024. |
Yes, that's clear enough I would say the only factor that makes me 👍 is that we are gonna add it in the very next minor version. Another topic is the generator-js. It would be awesome to throw some warnings when a parameter from v2 is not supported in v3. However, I do not see we do that atm, we do not log any line or return some diagnostics but rather the transformed doc. Can we maybe add somewhere some logic that adds a commented line in the final document for each unsupported parameter saying this will be or not supported soon? cc @jonaslagoni |
Do you mean the converter? If so, we already do give the user information about this in the form of a warning 🙂 |
@smoya I mean't I haven't seen any production-used asyncapi document that would use
@smoya what you mention is addressed in asyncapi/converter-js#192 by @jonaslagoni @jonaslagoni did you remember to add it to migration guide? |
@derberg doing it today yea 👍 |
+1 |
This issue has been automatically marked as stale because it has not had recent activity 😴 It will be closed in 120 days if no further activity occurs. To unstale this issue, add a comment with a detailed explanation. There can be many reasons why some specific issue has no activity. The most probable cause is lack of time, not lack of interest. AsyncAPI Initiative is a Linux Foundation project not owned by a single for-profit company. It is a community-driven initiative ruled under open governance model. Let us figure out together how to push this issue forward. Connect with us through one of many communication channels we established here. Thank you for your patience ❤️ |
Just to chime in that we use patters for various parameters that are more open in our channel (topic) structure. No being able to document them is regression. 2.6.0 works fine but yes it is used in production. |
Even if the example parameters:
streetlightId:
docHint:
type: integer This would allow you to keep enforcing only strings for the parameters, but allow more complex types in tools like the AsyncApi Studio |
Hey, chiming in with what @SebastienGllmt mentioned. I've already posted in the Slack as well but essentially:
components:
parameters:
deviceId:
description: The ID of the device. must be an integer. PS: I'm advocating for AsyncAPI usage in the company, they're a higher up, and it's a little awkward to come back and say "hey hey, looks like it's just a limitation of AsyncAPI in this version, hopefully it'll be fixed later" (but like in hopefully nicer than I can say here 😄 ) |
In short, no more JSON schema for parameters in v3 -> https://github.com/asyncapi/spec/blob/next-major-spec/spec/asyncapi.md#user-content-parameter-object
But I just discovered one example that actually uses
pattern
keyword from JSON schema -> https://github.com/asyncapi/spec/blob/master/examples/rpc-client.yml#L21I think that the impact is small, will not affect adoption and it is completely fine if we add it v3.1
But I want to make sure other codeowners don't see a problem
cc codeowners @fmvilas @dalelane @smoya @char0n
fyi @jonaslagoni
The text was updated successfully, but these errors were encountered: