Work on 3.0 release - Githubissues

Release 3.0.0 is scheduled for September.

Detailed info

https://github.com/asyncapi/spec/blob/master/RELEASE_PROCESS.md

Kick-off

Release coordinating and contributing: https://www.youtube.com/watch?v=9lJY5NcLMKY
Contribution guidelines: https://github.com/asyncapi/spec/blob/master/CONTRIBUTING.md
Release journal: https://github.com/asyncapi/community/issues/163

Meetings

Previous meeting list:

- https://github.com/asyncapi/community/issues/235#issuecomment-1016483507 - https://github.com/asyncapi/community/issues/250 - https://github.com/asyncapi/community/issues/254 - https://github.com/asyncapi/community/issues/270 - https://github.com/asyncapi/community/issues/282 - https://github.com/asyncapi/community/issues/298 - https://github.com/asyncapi/community/issues/307 - https://github.com/asyncapi/community/issues/330 - https://github.com/asyncapi/community/issues/346 - https://github.com/asyncapi/community/issues/366 - https://github.com/asyncapi/community/issues/378 - https://github.com/asyncapi/community/issues/394 - https://github.com/asyncapi/community/issues/407 - https://github.com/asyncapi/community/issues/410 - https://github.com/asyncapi/community/issues/417 - https://github.com/asyncapi/community/issues/427 - https://github.com/asyncapi/community/issues/435 - https://github.com/asyncapi/community/issues/443 - https://github.com/asyncapi/community/issues/453 - https://github.com/asyncapi/community/issues/464 - https://github.com/asyncapi/community/issues/476 - https://github.com/asyncapi/community/issues/491 - https://github.com/asyncapi/community/issues/502 - https://github.com/asyncapi/community/issues/518 - https://github.com/asyncapi/community/issues/531 - https://github.com/asyncapi/community/issues/546 - https://github.com/asyncapi/community/issues/564 - https://github.com/asyncapi/community/issues/575 - https://github.com/asyncapi/community/issues/587 - https://github.com/asyncapi/community/issues/599 - https://github.com/asyncapi/community/issues/624 - https://github.com/asyncapi/community/issues/635 - https://github.com/asyncapi/community/issues/649 - https://github.com/asyncapi/community/issues/670 - https://github.com/asyncapi/community/issues/699 - https://github.com/asyncapi/community/issues/714 - https://github.com/asyncapi/community/issues/734 - https://github.com/asyncapi/community/issues/737 - https://github.com/asyncapi/community/issues/760 - https://github.com/asyncapi/community/issues/761 - https://github.com/asyncapi/community/issues/812 - https://github.com/asyncapi/community/issues/823 - https://github.com/asyncapi/community/issues/847

Next meeting: https://github.com/asyncapi/community/issues/857

Progress 🔥

All issues for v3 are now complete 🔥

"Completed"

All completed, either introduced, rejected, or not being to work on:

[x] https://github.com/asyncapi/spec/issues/622 ~@magicmatatjahu~ @GreenRover
- [x] Reached RFC-1
- [x] Introduced changes to spec - ~https://github.com/asyncapi/spec/pull/797~ https://github.com/asyncapi/spec/pull/910
- [x] Reached RFC-2
- [x] Finished changes to spec - ~https://github.com/asyncapi/spec/pull/797~ https://github.com/asyncapi/spec/pull/910
- [x] Introduced changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/370 @smoya
- [x] Introduced changes to parser-js - https://github.com/asyncapi/parser-js/pull/814 @smoya
- [x] Reached RFC-3
- [x] Finished changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/370 @smoya
- [x] Finished changes to parser-js - https://github.com/asyncapi/parser-js/pull/814 @smoya
- [x] What is next?
[x] https://github.com/asyncapi/spec/issues/583 - @fmvilas
- [x] Reached RFC-1
- [x] Introduced changes to spec - https://github.com/asyncapi/spec/pull/935
- [x] Reached RFC-2
- [x] Finished changes to spec - https://github.com/asyncapi/spec/pull/935
- [x] Introduced changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/415
- [x] Introduced changes to parser-js - https://github.com/asyncapi/parser-js/pull/816
- [x] Reached RFC-3
- [x] Finished changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/415
- [x] Finished changes to parser-js - https://github.com/asyncapi/parser-js/pull/816
[x] https://github.com/asyncapi/spec/issues/505 @magicmatatjahu
- [x] Reached RFC-1
- [x] Introduced changes to spec - https://github.com/asyncapi/spec/pull/907
- [x] Reached RFC-2
- [x] Finished changes to spec - https://github.com/asyncapi/spec/pull/907 @jonaslagoni
- ~Introduced changes to spec-json-schema~
- [x] Introduced changes to parser-js - https://github.com/asyncapi/parser-js/pull/744
- [x] Reached RFC-3
- ~Finished changes to spec-json-schema~
- [x] Finished changes to parser-js - https://github.com/asyncapi/parser-js/pull/744 @jonaslagoni
[x] #658 @jonaslagoni
- [x] We had our first live discussion: https://www.youtube.com/watch?v=Vl8Nn3GOJiE
- [x] Currently, there does not seem to be enough traction and a need for this change. Therefore I will not push any further.
[x] Allow referencing non-JSON structures such as Protobuf, XML, XSD, etc @jonaslagoni
- [x] Further progress can be followed here: https://github.com/asyncapi/spec/issues/881
[x] https://github.com/asyncapi/spec/issues/795 @magicmatatjahu
- [x] Reached RFC-1
- [x] Introduced changes to spec - https://github.com/asyncapi/spec/pull/796
- [x] Reached RFC-2
- [x] Finished changes to spec - https://github.com/asyncapi/spec/pull/796
- [x] Introduced changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/315
- [x] Introduced changes to parser-js - https://github.com/asyncapi/parser-js/pull/677
- [x] Reached RFC-3
- [x] Finished changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/315
- [x] Finished changes to parser-js - https://github.com/asyncapi/parser-js/pull/677
[x] Improve components and what can be defined within them @magicmatatjahu
- [x] Reached RFC-1
- [x] Introduced changes to spec - https://github.com/asyncapi/spec/pull/792
- [x] Reached RFC-2
- [x] Finished changes to spec - https://github.com/asyncapi/spec/pull/792
- [x] Introduced changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/245
- [x] Introduced changes to parser-js - https://github.com/asyncapi/parser-js/pull/664
- [x] Reached RFC-3
- [x] Finished changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/245
- [x] Finished changes to parser-js - https://github.com/asyncapi/parser-js/pull/664
[x] Cleaning up root object @magicmatatjahu
- [x] Reached RFC-1
- [x] Introduced changes to spec - https://github.com/asyncapi/spec/pull/794
- [x] Reached RFC-2
- [x] Finished changes to spec - https://github.com/asyncapi/spec/pull/794
- [x] Introduced changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/244
- [x] Introduced changes to parser-js - https://github.com/asyncapi/parser-js/pull/664
- [x] Reached RFC-3
- [x] Finished changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/244
- [x] Finished changes to parser-js - https://github.com/asyncapi/parser-js/pull/664
[x] https://github.com/asyncapi/spec/issues/618 @smoya
- [X] https://github.com/asyncapi/spec/issues/661 @smoya
- [X] Reached RFC-1
  - [x] Introduced changes to spec https://github.com/asyncapi/spec/pull/827
- [X] Reached RFC-2
  - [X] Finished changes to spec https://github.com/asyncapi/spec/pull/827
  - [X] Introduced changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/264
  - [x] Introduced changes to parser-js - https://github.com/asyncapi/parser-js/pull/654
- [X] Reached RFC-3
  - [X] Finished changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/264
  - [x] Finished changes to parser-js - https://github.com/asyncapi/parser-js/pull/654
- [x] https://github.com/asyncapi/spec/issues/663 @smoya
- [x] Reached RFC-1
  - [x] Introduced changes to spec - https://github.com/asyncapi/spec/pull/827
- [X] Reached RFC-2
  - [x] Finished changes to spec - https://github.com/asyncapi/spec/pull/827
  - [x] Introduced changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/264
  - [X] Introduced changes to parser-js - https://github.com/asyncapi/parser-js/pull/654
- [X] Reached RFC-3
  - [X] Finished changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/264
  - [X] Finished changes to parser-js - https://github.com/asyncapi/parser-js/pull/654
[x] #699 @char0n
- [x] https://github.com/asyncapi/spec/pull/777
  - [x] Implementation ready
  - [x] Reviewed
  - [x] Merged
[x] https://github.com/asyncapi/spec/issues/829 @fmvilas
- [x] Reached RFC-1
  - [x] Introduced changes to spec - https://github.com/asyncapi/spec/pull/852
- [x] Reached RFC-2
  - [x] Finished changes to spec - https://github.com/asyncapi/spec/pull/852
  - [x] Introduced changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/316
  - [x] Introduced changes to parser-js - https://github.com/asyncapi/parser-js/pull/708
- [x] Reached RFC-3
  - [x] Finished changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/316
  - [x] Finished changes to parser-js - https://github.com/asyncapi/parser-js/pull/708
[x] https://github.com/asyncapi/spec/issues/94 @GreenRover
- [x] 1st Discussion around potential solution: https://github.com/asyncapi/community/issues/352
- [x] 2nd Discussion around potential solution: https://github.com/asyncapi/community/issues/368
- [x] 3rd Discussion around potential solution: https://github.com/asyncapi/community/issues/377
- [x] Agreement reached, progress blocked by:
- [x] https://github.com/asyncapi/spec/pull/827
- [x] https://github.com/asyncapi/spec/issues/663
- [x] Reached RFC-2
- [x] Finished changes to spec - https://github.com/asyncapi/spec/pull/847
- [x] Introduced changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/330
- [x] Introduced changes to parser-js - https://github.com/asyncapi/parser-js/issues/732
- [x] Reached RFC-3
- [x] Finished changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/330
- [x] Finished changes to parser-js - https://github.com/asyncapi/parser-js/pull/745
[x] https://github.com/asyncapi/spec/pull/888 - @fmvilas
- [x] Reached RFC-1
- [x] Introduced changes to spec - https://github.com/asyncapi/spec/pull/888
- [x] Reached RFC-2
- [x] Finished changes to spec - https://github.com/asyncapi/spec/pull/888
- [x] Introduced changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/329
- [x] Introduced changes to parser-js - https://github.com/asyncapi/parser-js/pull/708
- [x] Reached RFC-3
- [x] Finished changes to spec-json-schema - https://github.com/asyncapi/spec-json-schemas/pull/329
- [x] Finished changes to parser-js - https://github.com/asyncapi/parser-js/pull/708

Tooling progression

This is the list of tooling issues and PR's that are tied together with the major version spec changes.

[x] Intent and parser API - https://github.com/asyncapi/parser-js/issues/401
- [x] Prioritied PR: https://github.com/asyncapi/parser-api/pull/71
[x] AsyncAPI JSON Schema improvements
- [x] Split sub schemas https://github.com/asyncapi/spec-json-schemas/issues/127 - @jonaslagoni
- [X] Implementation ready
- [x] Reviewed
- [x] Merged
- [x] Provide JSON Schema files for bindings in spec-json-schemas https://github.com/asyncapi/bindings/issues/113 - @jonaslagoni
- [x] Add all schemas from the binding repository https://github.com/asyncapi/spec-json-schemas/pull/225
- [x] Add schemas for the different bindings https://github.com/asyncapi/spec-json-schemas/pull/224
- [x] https://github.com/asyncapi/spec-json-schemas/pull/239
- [x] https://github.com/asyncapi/website/issues/870 - @smoya
[x] https://github.com/asyncapi/parser-js/issues/736 - @smoya
[x] https://github.com/asyncapi/spec-json-schemas/issues/367 - @smoya

General Todo list

The Todo list is what is needed to be completed and in which order that is outside the general progress list.

[x] Splitting sub schemas https://github.com/asyncapi/spec-json-schemas/issues/127
- [x] Adapt release process https://github.com/asyncapi/spec/pull/659
  - [x] Implementation ready
  - [X] Reviewed
  - [x] Merged
- [x] Update usage of the new spec-json-schemas package https://github.com/asyncapi/parser-js/pull/423
  - [x] Implementation ready
  - [x] Reviewed
  - [x] Merged
- [x] Expose all schema files remotely https://github.com/asyncapi/website/pull/680
  - [x] Implementation ready
  - [x] Reviewed
  - [x] Merged
[x] Create new next-major-spec branches
- [x] In the spec-json-schemas repo
  - [x] add branch next-major-spec
  - [x] add next-major-spec to list of release branches - https://github.com/asyncapi/spec-json-schemas/pull/202
- [x] In the spec repo
  - [x] add branch next-major-spec
- [x] in the bindings repo
  - [x] add branch next-major-spec
- [x] in the parser repo
  - [x] add branch next-major-spec
  - [x] add next-major-spec to list of release branches - https://github.com/asyncapi/parser-js/pull/518
- [x] in the generator repo
  - [x] add branch next-major
  - [x] add next-major to list of release branches - https://github.com/asyncapi/generator/pull/755
[x] Update release branches
- [x] spec - https://github.com/asyncapi/spec/pull/753
- [x] spec - update with upstream https://github.com/asyncapi/spec/pull/758
- [x] spec-json-schemas - https://github.com/asyncapi/spec-json-schemas/pull/221
- [x] spec-json-schemas - update with upstream https://github.com/asyncapi/spec-json-schemas/pull/205
- [x] parser-js - https://github.com/asyncapi/parser-js/pull/517
- [x] parser-js - update with upstream https://github.com/asyncapi/parser-js/pull/525
[x] Create draft release notes - https://github.com/asyncapi/website/pull/659
[x] Create draft migration guidelines - https://github.com/asyncapi/website/pull/660
[x] Create release PRs
- [x] spec - https://github.com/asyncapi/spec/pull/759
- [x] spec-json-schemas - https://github.com/asyncapi/spec-json-schemas/pull/208
- [x] parser-js - https://github.com/asyncapi/parser-js/pull/526
[x] https://github.com/asyncapi/spec/pull/803
- [x] Reviewed
- [x] Merged
[x] https://github.com/asyncapi/spec/pull/806
- [x] Reviewed
- [x] Merged
[x] Change contribution guidelines for binding changes to also include spec-json-schema repo: https://github.com/asyncapi/bindings/issues/113
[x] Inspect bindings for v3 - https://github.com/asyncapi/bindings/issues/182
- [x] https://github.com/asyncapi/bindings/pull/202 @jonaslagoni
- [x] https://github.com/asyncapi/bindings/pull/203 @jonaslagoni
- [x] https://github.com/asyncapi/bindings/pull/204 @jonaslagoni
- [x] https://github.com/asyncapi/bindings/pull/205 @jonaslagoni
- [x] https://github.com/asyncapi/bindings/pull/206 @jonaslagoni
- [x] https://github.com/asyncapi/bindings/pull/207 @jonaslagoni
- [x] https://github.com/asyncapi/bindings/pull/213 @whitlockjc
[ ] Figure out which tools need to be updated for v3, and which are complete.
[ ] General documentation changes for the website: https://github.com/asyncapi/website/issues/1433 - @alequetzalli
- [x] https://github.com/asyncapi/website/pull/1806 @jonaslagoni
- [x] https://github.com/asyncapi/website/issues/1434
  - [ ] https://github.com/asyncapi/website/pull/2071
- [x] https://github.com/asyncapi/website/issues/1435
- [x] https://github.com/asyncapi/website/issues/1436
- [x] https://github.com/asyncapi/website/issues/1437
- [x] https://github.com/asyncapi/website/issues/1438
- [x] https://github.com/asyncapi/website/issues/1439
- [x] https://github.com/asyncapi/website/issues/1440
- [x] https://github.com/asyncapi/website/issues/1441
- [x] Write the migration guide: https://github.com/asyncapi/website/pull/2008 @jonaslagoni
- [x] Write the release notes:
  - [x] Initial release notes https://github.com/asyncapi/website/pull/659 @jonaslagoni
  - [x] Polishing release notes @jonaslagoni
[x] Update all spec examples, once https://github.com/asyncapi/converter-js/issues/110 is solved. - https://github.com/asyncapi/spec/pull/947
[x] Notify tsc_members about upcoming release
[x] Prepare pull requests to merge release branches into master
- [x] spec - https://github.com/asyncapi/spec/pull/759
- [x] spec-json-schemas - https://github.com/asyncapi/spec-json-schemas/pull/208
- [x] parser-js - https://github.com/asyncapi/parser-js/pull/526
- [x] website - https://github.com/asyncapi/website/pull/1851
[x] Merge release branches into master
- [x] spec - https://github.com/asyncapi/spec/pull/759
- [x] spec-json-schemas - https://github.com/asyncapi/spec-json-schemas/pull/208
- [x] parser-js - https://github.com/asyncapi/parser-js/pull/526
- [x] website - https://github.com/asyncapi/website/pull/1851
[x] Write release notes for the releases on Github
[x] Create releases on Github
- [x] spec
- [x] spec-json-schemas
- [x] parser-js
[x] Create retrospective meeting for 3.0 once released to discuss improvements to major version releases.

I want to champion something!

First of all, thank you! 🙇

We use the following milestone https://github.com/asyncapi/spec/milestone/18 to track all the issues that needs to have been considered before we can release 3.0. So pick one the issues that needs champion, and drive it forward!

Reach out to slack, in the issue, or our regular meetings if you need anything!

If you need anything changed in this progress issue, leave a comment below with what to update 🙂

asyncapi / spec

Work on 3.0 release #691