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

Video 3 - draft script #10

Merged
merged 38 commits into from Feb 23, 2023
Merged
Changes from all commits
Commits
Show all changes
38 commits
Select commit Hold shift + click to select a range
63d2d07
Delete VIDEO_1_SCRIPT.md
Barbanio Mar 3, 2022
3d54f86
Update VIDEO_3_SCRIPT.md
Barbanio Mar 31, 2022
02aa29c
Update VIDEO_3_SCRIPT.md
Barbanio Mar 31, 2022
de736d9
Update VIDEO_3_SCRIPT.md
Barbanio Mar 31, 2022
97bcded
Update VIDEO_3_SCRIPT.md
Barbanio Mar 31, 2022
01329d7
Update VIDEO_3_SCRIPT.md
Barbanio Apr 8, 2022
fa0ce53
Update VIDEO_3_SCRIPT.md
Barbanio Apr 8, 2022
5356cc2
Update VIDEO_3_SCRIPT.md
Barbanio Apr 8, 2022
cc694c1
Update VIDEO_3_SCRIPT.md
Barbanio Apr 8, 2022
16cb004
Update VIDEO_3_SCRIPT.md
Barbanio Apr 8, 2022
75e2677
Update VIDEO_3_SCRIPT.md
Barbanio Apr 8, 2022
69c9ed3
Update VIDEO_3_SCRIPT.md
Barbanio Apr 8, 2022
41be3e7
Update VIDEO_3_SCRIPT.md
Barbanio Apr 8, 2022
1e78df9
Update VIDEO_3_SCRIPT.md
Barbanio Apr 8, 2022
08eb11e
Update VIDEO_3_SCRIPT.md
Barbanio Apr 18, 2022
6372210
Update VIDEO_3_SCRIPT.md
Barbanio Apr 22, 2022
e1e3a8c
Update VIDEO_3_SCRIPT.md
Barbanio Apr 22, 2022
c5620d2
Update VIDEO_3_SCRIPT.md
Barbanio Apr 22, 2022
0874683
Update VIDEO_3_SCRIPT.md
Barbanio May 9, 2022
0dd81ad
Update VIDEO_3_SCRIPT.md
Barbanio May 9, 2022
e86b082
Update VIDEO_3_SCRIPT.md
Barbanio Jun 10, 2022
08178f2
Update VIDEO_3_SCRIPT.md
Barbanio Jun 14, 2022
874c132
Update VIDEO_3_SCRIPT.md
Barbanio Jun 14, 2022
2093bd9
Update VIDEO_3_SCRIPT.md
Barbanio Jun 14, 2022
d489f99
Update VIDEO_3_SCRIPT.md
Barbanio Jun 14, 2022
98a5db4
Update VIDEO_3_SCRIPT.md
Barbanio Jun 14, 2022
b20bde6
Update VIDEO_3_SCRIPT.md
Barbanio Jun 14, 2022
b1d707e
Update VIDEO_3_SCRIPT.md
Barbanio Jun 14, 2022
c00fce6
Update VIDEO_3_SCRIPT.md
Barbanio Jun 14, 2022
17ffb30
Update VIDEO_3_SCRIPT.md
Barbanio Jun 14, 2022
c8db855
Update VIDEO_3_SCRIPT.md
Barbanio Jun 16, 2022
60a1b0e
Update VIDEO_3_SCRIPT.md
Barbanio Jun 23, 2022
0a0bed3
Update VIDEO_3_SCRIPT.md
Barbanio Jul 25, 2022
eacb4a2
Update VIDEO_3_SCRIPT.md
Barbanio Aug 4, 2022
e55cde4
Revised text.
Barbanio Oct 14, 2022
0976e35
Text updated.
Barbanio Oct 14, 2022
c9054ee
Selected text of the short version of the video.
Barbanio Jan 17, 2023
e8a7ea6
merging master
Barbanio Feb 23, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
62 changes: 62 additions & 0 deletions VIDEO_3_SCRIPT.md
@@ -0,0 +1,62 @@
# Video 3: What is AsyncAPI

Hello everyone! Welcome back!

My name is ... This video will help you understand what AsyncAPI is and how to continue learning about this Open-Source project.

In this video, we'll talk about:

- What is AsyncAPI Spec, and how did it come about
- What AsyncAPI brings
- What is AsyncAPI Initiative, and what are its objectives
- AsyncAPI on the long-term

Ready? Let's get started!

## What is ***AsyncAPI Spec***, and how did it come about

AsyncAPI ***is an open-source specification founded by Fran Mendez in 2017. Inspired by OpenAPI, it aims at making working with EDA as easy as working with REST APIs. But, how to do that?***

***The Spec describes and documents message-driven APIs in a machine-readable format. It's protocol-agnostic, so you can use it for APIs that work over AMQP, MQTT, WebSockets, Kafka, STOMP, HTTP, etc.***

***It defines a set of files required to describe an API. These files can then be used to create utilities, such as documentation, integration and/or testing tools.***

The AsyncAPI Specification doesn't assume any kind of software topology, architecture or pattern. Therefore, a server may be a message broker, a web server or any other kind of computer program capable of sending and/or receiving data. However, AsyncAPI offers a mechanism called "bindings". Those are the means of transmitting messages from a Service Component Architecture component to a web service and vice versa. They aims to help with more specific information about the protocol and/or the topology. The AsyncAPI specification settles the base for a greater and better tooling ecosystem for EDA's.

## What AsyncAPI brings
Barbanio marked this conversation as resolved.
Show resolved Hide resolved

***Its main contribution to the world of APIs is the standardization and simplification of the methods to describe and design EDAs.***

***We could even say that AsyncAPI is a specification that facilitates and simplifies working with APIs,speeding up the work of developers. Having defined, documented, and accepted the communication between APIs, AsyncAPI provides an increased and more efficient information control.***

AsyncAPI Initiative ***also develops and maintains an extensive amount of AsyncAPI tools that accelerate application development.*** The tools' mechanisms for automating complex and essential tasks facilitate code generation, documentation generation, validators, etc.

***AsyncAPI specification is maintained under the AsyncAPI Initiative.***

## ***What is AsyncAPI Initiative***, and what are its objectives

The AsyncAPI Initiative ***is a community that not only maintains the specification. The goal of the initiative is to provide proper tooling support for the spec that goes from documentation to code generation and from discovery to event management.***

AsyncAPI Initiative currently aims at accomplishing three main goals:

1. Reuse other specifications. You can change to most developers complement the event architecture with REST (OpenAPI), GraphQL, or Avro and CloudEvents, embracing reusability.

2. Make the development experience super seamless, from idea to production. Users should be able to create their first API in a matter of minutes without prior knowledge of AsyncAPI.

3. Be one of the most popular API spec. As a community-driven project run under open governance, AsyncAPI needs a constantly growing community taking care of it.

## AsyncAPI on the long-term

An important step to AsyncAPI initiative consolidation was to partner with Postman at the end of 2020. Thanks to this partnership, a dedicated department works full-time on the AsyncAPI spec, its tools, and community-building aspects.

***The strategy is to continue implementing and improving the resources that make AsyncAPI more complete and solid. An agreement to host AsyncAPI under a neutral foundation like Linux, guarantees the long-term sustainability and success of the project.***

## Goodbye to the viewer

We hope you enjoyed hearing about the origin of AsyncAPI and what it brings. The next video will highlight the similarities and differences between AsyncAPI and OpenAPI.

Thank you for watching!

---

* The italic and bold text is the script of the short version of the video.