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

chore(blog): announcing the work on AsyncAPI spec 3.0 release #611

Merged
merged 6 commits into from
Mar 10, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 59 additions & 0 deletions pages/blog/async-api-spec-3.0-release.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---
title: "AsyncAPI Spec 3.0 is coming!"
date: 2022-03-10T06:00:00+01:00
type: Communication
tags:
- Specification
- Announcement
- Release
cover: /img/posts/async-api-spec3.0-release/cover.webp
authors:
- name: Harsh Mishra
photo: /img/avatars/harsh.webp
link: https://www.linkedin.com/in/harshcasper/
excerpt: 'Announcing the start of work on AsyncAPI Spec 3.0. Check out all the potential new features coming to AsyncAPI 3.0 and how you can get involved!'
featured: false
---

AsyncAPI is a specification for describing your event-driven architecture. Our specification allows you to describe and document your message-driven APIs into a human-readable format. The AsyncAPI community is currently inching towards a 3.0 release that will bring together multiple features, enhancements, and breaking changes. We follow [release cadence](https://github.com/asyncapi/spec/blob/master/RELEASE_PROCESS.md#release-cadence) and we will continue to release the Spec to the community as we continue to build on it.

## Potential Changes

Many new features for AsyncAPI Spec 3.0 are being planned, written, and discussed. Among them are:

- [Introduce Schema Versioning](https://github.com/asyncapi/spec/issues/697)
- [Introducing Data Format bindings](https://github.com/asyncapi/spec/issues/694)
- [Making servers aware of their service name](https://github.com/asyncapi/spec/issues/654)
- [Solving publish/subscribe confusion](https://github.com/asyncapi/spec/issues/618)
- [What does an AsyncAPI file mean](https://github.com/asyncapi/spec/issues/628)
- [Fixing schema inconsistencies](https://github.com/asyncapi/spec/issues/583)
- [Defining a schema format other than the default one](https://github.com/asyncapi/spec/issues/622)
- [Remove `$ref` field from `Channel Item Object`](https://github.com/asyncapi/spec/issues/699)
- [Application of message traits (intentionally) replacing existing attributes](https://github.com/asyncapi/spec/issues/505)
- [Address perspective and channel reuse issues through introducing 'endpoint' concept](https://github.com/asyncapi/spec/issues/599)

The tooling issues and pull requests which are tied up with the Spec 3.0 release are:

- [Implement intent-driven Parser API](https://github.com/asyncapi/parser-js/issues/401)
- [Splitting out definitions into separate files](https://github.com/asyncapi/spec-json-schemas/issues/127)
- [Move binding JSON schema files to main JSON schema repository](https://github.com/asyncapi/bindings/issues/113)

We are using [this GitHub milestone](https://github.com/asyncapi/spec/milestone/18) to track down all the issues related to Spec 3.0 release. If you are willing to take up an issue, filter the issues with `needs champion` label and drive the initiative forward. We also have a [release journal](https://github.com/asyncapi/community/issues/163) for the upcoming Spec 3.0 release to keep note of all the references, build the right documentation, and track the progress for the upcoming release.

## Contributing to the release

AsyncAPI is a community-driven project and we welcome all kinds of contributions! To get started, join our [Slack workspace](http://asyncapi.com/slack-invite). After joining, reach out to us on the `#03_specification` channel and participate in the conversations.

To better understand AsyncAPI and how the Spec 3.0 release will play out, we recommend watching our [past meeting recordings](https://www.youtube.com/watch?v=CLNgLB4-UnA&list=PLbi1gRlP7pihClJY-kXuTRRJ8n1awb0VV). To know how you can contribute, we recommend checking out our [contributing guidelines](https://github.com/asyncapi/spec/blob/master/CONTRIBUTING.md). If you wish to keep track of all the work that is happening on the Spec 3.0 release, we recommend checking out our [GitHub issue](https://github.com/asyncapi/spec/issues/691).

Before landing in your contributions, make sure you follow our [Code of Conduct](https://github.com/asyncapi/.github/blob/master/CODE_OF_CONDUCT.md) and the pull request you raised is [described properly](https://github.com/asyncapi/.github/blob/master/CONTRIBUTING.md#conventional-commits). To know how we collaborate using Git & GitHub, follow the [Git workflow](https://github.com/asyncapi/.github/blob/master/git-workflow.md) that we have developed for contributors.

## When will the release happen?

We are yet to arrive at a date but the community is working towards releasing this by the end of 2022. Currently, we meet every two weeks to discuss the upcoming Spec 3.0 release and share updates and you are welcome to join it! We are going to have our next meeting on [UTC 16:00 on March 16, 2022](https://github.com/asyncapi/community/issues/270). You can access the [AsyncAPI Calendar](https://calendar.google.com/calendar/u/0/[email protected]) and explore our upcoming meetings.

The release will happen gradually, where the new specification and tooling will live in coexistence until there is a collective consensus that everything is ready. This gives everyone an easy way to test out the new changes and provide feedback before the release. Finally, after rigorous testing, we will make an official announcement about our release!

Join us and help make the upcoming release a successful one!

(Cover picture by [Andrew Coelho](https://unsplash.com/@andrewcoelho) on [Unsplash](https://unsplash.com/))
Binary file added public/img/avatars/harsh.webp
Binary file not shown.
Binary file not shown.