Skip to content
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

Fix: Fixed autogenerated description #189

Merged
merged 3 commits into from
Jun 5, 2023

Conversation

ctasada
Copy link
Collaborator

@ctasada ctasada commented May 31, 2023

When defining an @AsyncOperation description like in

@AsyncOperation(
    channelName = "channel-name",
    description = "My channel description")

The generated AsyncAPI schema was always showing Auto-generated description
now properly shows the defined description value.

@ctasada ctasada force-pushed the ctasada/fix-description branch from 81def66 to 7db212b Compare May 31, 2023 10:22
Copy link
Collaborator

@sam0r040 sam0r040 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks a lot for your contribution, I just made a suggestion on how to resolve the FIXME comment.

Copy link
Collaborator

@sam0r040 sam0r040 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks a lot for your contribution, I just made a suggestion on how to resolve the FIXME comment.

@timonback
Copy link
Member

@ctasada Is there anything anything else you like to see being included in the next release?

@ctasada
Copy link
Collaborator Author

ctasada commented Jun 5, 2023

@ctasada Is there anything anything else you like to see being included in the next release?

Nothing urgent. If we can get another release done in 2-4 weeks I think I'm good 😉

Carlos Tasada added 2 commits June 5, 2023 18:22
When defining an `@AsyncOperation` description like in

```
@AsyncOperation(
    channelName = "channel-name",
    description = "My channel description")
```

The generated AsyncAPI schema was always showing `Auto-generated description`
now properly shows the defined `description` value.
The Message description was not properly parsed and wrongly showed the Operation description.

Until it's properly fixed, we decided to remove this misguiding description
@ctasada ctasada force-pushed the ctasada/fix-description branch from 7db212b to cd138eb Compare June 5, 2023 16:46
The Message description was not properly parsed and wrongly showed the Operation description.

Until it's properly fixed, we decided to remove this misguiding description
@timonback timonback requested a review from sam0r040 June 5, 2023 18:50
@timonback timonback merged commit a886c0e into springwolf:master Jun 5, 2023
ctasada pushed a commit to ctasada/springwolf-core that referenced this pull request Jun 6, 2023
While working at springwolf#189 we found out that the provided Message description was, in fact, the one associated to the Operation. As a result we decided to fully remove the description until we could fix it.

This PR adds support for Message description.

Any `Message` object, annotated with `@Schema` will use the annotation `description` value, as the Message description.

The https://www.springwolf.dev/docs/configuration/documenting-schemas documentation is already stating this scenario, so I don't think we need further documentation updates.
ctasada pushed a commit to ctasada/springwolf-core that referenced this pull request Jun 6, 2023
While working at springwolf#189 we found out that the provided Message description was, in fact, the one associated to the Operation. As a result we decided to fully remove the description until we could fix it.

This PR adds support for Message description.

Any `Message` object, annotated with `@Schema` will use the annotation `description` value, as the Message description.

The https://www.springwolf.dev/docs/configuration/documenting-schemas documentation is already stating this scenario, so I don't think we need further documentation updates.
ctasada pushed a commit to ctasada/springwolf-core that referenced this pull request Jun 7, 2023
While working at springwolf#189 we found out that the provided Message description was, in fact, the one associated to the Operation. As a result we decided to fully remove the description until we could fix it.

This PR adds support for Message description.

Any `Message` object, annotated with `@Schema` will use the annotation `description` value, as the Message description.

The https://www.springwolf.dev/docs/configuration/documenting-schemas documentation is already stating this scenario, so I don't think we need further documentation updates.
timonback pushed a commit that referenced this pull request Jun 7, 2023
While working at #189 we found out that the provided Message description was, in fact, the one associated to the Operation. As a result we decided to fully remove the description until we could fix it.

This PR adds support for Message description.

Any `Message` object, annotated with `@Schema` will use the annotation `description` value, as the Message description.
@ctasada ctasada deleted the ctasada/fix-description branch December 13, 2023 17:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants