diff --git a/pages/docs/concepts/application.md b/pages/docs/concepts/application.md new file mode 100644 index 000000000000..1f8aafc05b87 --- /dev/null +++ b/pages/docs/concepts/application.md @@ -0,0 +1,42 @@ +--- +title: Application +weight: 23 +--- + + +## What is an application? +An application is any computer program or a group of them. + +An application could also be a micro-service, IoT device (sensor), mainframe process, etc. Users may even write applications in different programming languages if they support one of the selected protocols. + +## Why do we need applications? +In Event-Driven Architecture (EDA), an application must be a `producer`, a `consumer`, or both. Applications must also use the protocols the server supports if they wish to connect and exchange messages. + +### Applications: producers and consumers +```mermaid +flowchart TD + A[PRODUCER application] --> B[message] + B --> C[channel] + C --> D[message] + D --> F[CONSUMER application] +``` +The above diagram describes a message communication traveling through a channel between a **PRODUCER application** and a **CONSUMER application**. + + +When writing your AsyncAPI document, make sure to describe what a user can do with your application; not what the application does. In other words, if your application is a producer, your AsyncAPI document should describe where users can subscribe to, to receive messages produced by your producer application. + + + diff --git a/pages/docs/concepts/channel.md b/pages/docs/concepts/channel.md index a44468ff4fa6..44a30bdd2376 100644 --- a/pages/docs/concepts/channel.md +++ b/pages/docs/concepts/channel.md @@ -30,9 +30,9 @@ The diagram above shows the communication between a `producer` and `consumer`, w title: 'Consumer', }, { - href:'/docs/concepts/message', + href:'/docs/concepts/application', type: 'next', - title: 'Message', + title: 'Application', } ]} /> diff --git a/pages/docs/concepts/message.md b/pages/docs/concepts/message.md index dd39f30a4a34..37c90b95844b 100644 --- a/pages/docs/concepts/message.md +++ b/pages/docs/concepts/message.md @@ -38,9 +38,9 @@ Overall, `events` are `messages` but not all `messages` are `events`. \ No newline at end of file