Skip to content

Commit

Permalink
Video 3 - draft script (#10)
Browse files Browse the repository at this point in the history
* Delete VIDEO_1_SCRIPT.md

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Alejandra Quetzalli  <alejandra.quetzalli@postman.com>

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Alejandra Quetzalli  <alejandra.quetzalli@postman.com>

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Alejandra Quetzalli  <alejandra.quetzalli@postman.com>

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Alejandra Quetzalli  <alejandra.quetzalli@postman.com>

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Fran Méndez <fmvilas@gmail.com>

* Update VIDEO_3_SCRIPT.md

Added Fran's and Lukasz's suggestions.

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Lukasz Gornicki <lpgornicki@gmail.com>

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Lukasz Gornicki <lpgornicki@gmail.com>

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Fran Méndez <fmvilas@gmail.com>

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Lukasz Gornicki <lpgornicki@gmail.com>

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Lukasz Gornicki <lpgornicki@gmail.com>

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Alejandra Quetzalli  <alejandra.quetzalli@postman.com>

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Fran Méndez <fmvilas@gmail.com>

* Update VIDEO_3_SCRIPT.md

Added change in the farewell, Fran's suggestion

* Update VIDEO_3_SCRIPT.md

Added Lukasz's and Fran's suggestion.

* Update VIDEO_3_SCRIPT.md

Added typo correction.

* Update VIDEO_3_SCRIPT.md

Added changes of added changes in the order of information in chronological order

* Update VIDEO_3_SCRIPT.md

Added typo correction

* Update VIDEO_3_SCRIPT.md

* Update VIDEO_3_SCRIPT.md

Added modifications to the text based on Lukasz's suggestions.

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Lukasz Gornicki <lpgornicki@gmail.com>

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Lukasz Gornicki <lpgornicki@gmail.com>

* Update VIDEO_3_SCRIPT.md

Added Lukasz's suggestion.

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Lukasz Gornicki <lpgornicki@gmail.com>

* Update VIDEO_3_SCRIPT.md

Added Lukasz's suggestion.

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Lukasz Gornicki <lpgornicki@gmail.com>

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Lukasz Gornicki <lpgornicki@gmail.com>

* Update VIDEO_3_SCRIPT.md

Co-authored-by: Lukasz Gornicki <lpgornicki@gmail.com>

* Update VIDEO_3_SCRIPT.md

Added typo corrections.

* Update VIDEO_3_SCRIPT.md

Added Valeria's suggestions.

* Update VIDEO_3_SCRIPT.md

Added Valeria's suggestion.

* Update VIDEO_3_SCRIPT.md

Added correction.

* Update VIDEO_3_SCRIPT.md

A typo has been corrected.

* Revised text.

* Text updated.

* Selected text of the short version of the video.

---------

Co-authored-by: Alejandra Quetzalli  <alejandra.quetzalli@postman.com>
Co-authored-by: Fran Méndez <fmvilas@gmail.com>
Co-authored-by: Lukasz Gornicki <lpgornicki@gmail.com>
  • Loading branch information
4 people committed Feb 23, 2023
1 parent 0bd3ea8 commit b2e84c7
Showing 1 changed file with 62 additions and 0 deletions.
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

***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.

0 comments on commit b2e84c7

Please sign in to comment.