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

AsyncAPI spec v3.0.0 release journal #163

Closed
smoya opened this issue Nov 9, 2021 · 12 comments
Closed

AsyncAPI spec v3.0.0 release journal #163

smoya opened this issue Nov 9, 2021 · 12 comments

Comments

@smoya
Copy link
Member

smoya commented Nov 9, 2021

This issue keeps a journal of the release process for AsyncAPI spec v3.0.0.
The journal format is gonna be accomplished by making GH comments. There is no particular format on those but feel free to suggest it if you feel it is necessary.

The main goals for such thing are:

  1. To have a common reference point for all people interested in keeping up with this current release process.
  2. To use it for building up documentation for the process of releasing versions that include breaking changes. A guideline as an outcome.
  3. To eventually and optionally write a blog post or a series of blog posts.

There is now an issue where we track progress on v3: asyncapi/spec#691, However this journal will stay here and will be used for tracking events and news regarding this release.

@smoya smoya added the keep-open label Nov 9, 2021
@asyncapi asyncapi deleted a comment from github-actions bot Nov 9, 2021
@smoya
Copy link
Member Author

smoya commented Nov 9, 2021

During today's SIG Meeting @jonaslagoni is gonna suggest a new recurring meeting for those interested in following and/or working on the v3.0.0 release efforts.

The creation of a "Working Group" might also be suggested so we have a group of people that will work on the release process of this v3.0.0 version.

More details can be found in #157

@quetzalliwrites
Copy link
Member

oh wow, this is nice!!

@jonaslagoni
Copy link
Member

jonaslagoni commented Nov 22, 2021

@smoya and I went down a bit of a rabbit hole that was triggered by referencing behavior, gathered everything under a blog post for visibility on the problem - asyncapi/website#461

This resulted in 3 new issues for both spec and parser-js library.

@smoya
Copy link
Member Author

smoya commented Dec 3, 2021

Parser-JS implementing the Parser-API (asyncapi/parser-js#401) could be considered a thing now that we would need to adapt the parser for 3.0.0 changes.

We would like to get a list of pros/cons about adopting the Parser-API, for later on presenting them to the community so we can all make a decision. In order to do some brainstorming so we can get such a list, we (@jonaslagoni and I) have scheduled a public meeting. Therefore we have asked @boyney123 and @alequetzalli to join us as well and they confirmed.

Meeting has been scheduled for Monday Dec 6, 8am PST, and it will be included as part of our Contributor-first meeting, so will be streamed via Youtube, Twitch, Twitter...

EDIT 7 Dec 2021:

During the meeting, we came out with some pros/cons about adopting Intent-driven API + Parser-API for our parsers. Here is the link (you can also add your thoughts!) https://hackmd.io/AYyrgWMQRXuOKl_VsxUbCA

@smoya
Copy link
Member Author

smoya commented Dec 3, 2021

@derberg has started a new GH Discussion here for "Start collecting AsyncAPI use cases".
This is extremely valuable for understanding what should v3.0.0 should cover, also what could be postponed to future versions, and how changes that are candidates to be in v3.0.0 could affect others.

@smoya
Copy link
Member Author

smoya commented Dec 29, 2021

I updated asyncapi/parser-js#401 reflecting all collected pros/cons of implementing the Intent-Driven API and Parser-API. So now the question we need to answer asap in there is, should we move forward?

@jonaslagoni
Copy link
Member

A final suggestion for the bi-weekly community meeting added and shared: #157 (comment)

Suggested starting date Wednesday 19th, 5 PM CET

@smoya
Copy link
Member Author

smoya commented Jan 20, 2022

A final suggestion for the bi-weekly community meeting added and shared: #157 (comment)

Suggested starting date Wednesday 19th, 5 PM CET

The meeting happened and it seems it had a good acceptance because people were very enthusiastic about keeping having more.
The meeting was recorded and can be watched on Youtube.

As a result of it, several issues were created so we can follow up and progress on several topics:

Thanks to @damaru-inc, @aricart, @magicmatatjahu, @boyney123, @dalelane, @jessemenning, @smoya, and @jonaslagoni (and @fmvilas via chat!) for participating, but also to all people connected on all streaming platforms.

@smoya
Copy link
Member Author

smoya commented Feb 17, 2022

More "Spec 3.0" Meetings happened during last weeks. I won't add a new update every time there is another one but instead, I'm leaving here this link where you can find all of the issues we created per event. They include the agenda, video recordings, live chats and notes.

https://github.com/asyncapi/community/issues?q=is%3Aissue+is%3Aclosed+%22Spec+3.0+Meeting%22

@jonaslagoni
Copy link
Member

I decided to add a migration guide for 3.0: asyncapi/website#660

What this evolves into is hard to say, let's see. However, we needed a place to write all the migration guides down so tools such as converters can be accurately adapted.

@smoya
Copy link
Member Author

smoya commented Oct 18, 2022

parser-js v2 has been released as beta. As per today, latest version is v2.0.0-next-major.6.

This is unblocking development of Spec v3.0.0 features, and the idea is to release this new parser-js version soon and with enough time to have it tested heavily before releasing Spec v3.0.0.

@jonaslagoni
Copy link
Member

As the release process for v3 is complete I am gonna close down this issue.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants
@smoya @jonaslagoni @quetzalliwrites and others