Merge branch 'master' into master

Author: NalinDalal

config/newsroom_videos.json

@@ -1,4 +1,10 @@
 [
+  {
+    "image_url": "https://i.ytimg.com/vi/awfB_mwUp1c/hqdefault.jpg",
+    "title": "Event-Driven and OpenTelemetry with Eduardo",
+    "description": "Implementing distributed tracing between producers and consumers.",
+    "videoId": "awfB_mwUp1c"
+  },
   {
     "image_url": "https://i.ytimg.com/vi/e_uo7_QMDd4/hqdefault.jpg",
     "title": "AsyncAPI Community Working Group Meeting, March 11th 2025",
@@ -22,11 +28,5 @@
     "title": "AsyncAPI Marketing Working Group Meeting",
     "description": "https://github.com/asyncapi/community/issues/1705.",
     "videoId": "gfKAcJthEGk"
-  },
-  {
-    "image_url": "https://i.ytimg.com/vi/awfB_mwUp1c/hqdefault.jpg",
-    "title": "Event-Driven and OpenTelemetry with Eduardo",
-    "description": "Implementing distributed tracing between producers and consumers.",
-    "videoId": "awfB_mwUp1c"
   }
 ]

dashboard.json

@@ -9,7 +9,7 @@
       "resourcePath": "/asyncapi/community/pull/1634",
       "repo": "asyncapi/community",
       "labels": [],
-      "score": 28.717458874925875
+      "score": 31.302030173669205
     },
     {
       "id": "I_kwDOBW5R_c5BIl5P",
@@ -85,7 +85,7 @@
       "resourcePath": "/asyncapi/website/pull/3726",
       "repo": "asyncapi/website",
       "labels": [],
-      "score": 14.645904026212197
+      "score": 15.220253203710714
     },
     {
       "id": "I_kwDODou01c5ZAFWh",
@@ -107,17 +107,6 @@
       ],
       "score": 14.07155484871368
     },
-    {
-      "id": "I_kwDOFLhIt85xI2wH",
-      "isPR": false,
-      "isAssigned": false,
-      "title": "Measure AsyncAPI Adoption",
-      "author": "fmvilas",
-      "resourcePath": "/asyncapi/community/issues/879",
-      "repo": "asyncapi/community",
-      "labels": [],
-      "score": 12.922856493716644
-    },
     {
       "id": "I_kwDOFLhIt86O7jFN",
       "isPR": false,
@@ -140,7 +129,42 @@
           "color": "0d67d3"
         }
       ],
-      "score": 12.635681904967385
+      "score": 13.210031082465903
+    },
+    {
+      "id": "I_kwDOFLhIt85xI2wH",
+      "isPR": false,
+      "isAssigned": false,
+      "title": "Measure AsyncAPI Adoption",
+      "author": "fmvilas",
+      "resourcePath": "/asyncapi/community/issues/879",
+      "repo": "asyncapi/community",
+      "labels": [],
+      "score": 12.922856493716644
+    },
+    {
+      "id": "I_kwDOFLhIt86sh4Es",
+      "isPR": false,
+      "isAssigned": false,
+      "title": "Donation of `Neuroglia.AsyncAPI`",
+      "author": "derberg",
+      "resourcePath": "/asyncapi/community/issues/1764",
+      "repo": "asyncapi/community",
+      "labels": [
+        {
+          "name": "vote",
+          "color": "EF813F"
+        },
+        {
+          "name": "gitvote",
+          "color": "ededed"
+        },
+        {
+          "name": "vote open",
+          "color": "ededed"
+        }
+      ],
+      "score": 12.348507316218127
     },
     {
       "id": "I_kwDOBW5R_c6pn_G2",
@@ -173,47 +197,18 @@
         }
       ],
       "score": 12.348507316218127
-    },
-    {
-      "id": "I_kwDOFLhIt86sh4Es",
-      "isPR": false,
-      "isAssigned": false,
-      "title": "Donation of `Neuroglia.AsyncAPI`",
-      "author": "derberg",
-      "resourcePath": "/asyncapi/community/issues/1764",
-      "repo": "asyncapi/community",
-      "labels": [
-        {
-          "name": "vote",
-          "color": "EF813F"
-        },
-        {
-          "name": "gitvote",
-          "color": "ededed"
-        },
-        {
-          "name": "vote open",
-          "color": "ededed"
-        }
-      ],
-      "score": 10.625459783722574
     }
   ],
   "goodFirstIssues": [
     {
-      "id": "I_kwDOFDnrNc6tb2y1",
-      "title": "[BUG] A YAML file is being generated instead of a JSON file when using the asyncapi new file command for generating JSON file",
+      "id": "I_kwDODwv8N86tpo_O",
+      "title": "Remove \"All rights reserved and the Copyright symbol\"",
       "isAssigned": false,
-      "resourcePath": "/asyncapi/cli/issues/1710",
-      "repo": "asyncapi/cli",
-      "author": "Sumitwarrior7",
+      "resourcePath": "/asyncapi/conference-website/issues/620",
+      "repo": "asyncapi/conference-website",
+      "author": "thulieblack",
       "area": "Unknown",
-      "labels": [
-        {
-          "name": "bug",
-          "color": "d73a4a"
-        }
-      ]
+      "labels": []
     },
     {
       "id": "I_kwDOFDnrNc6tHvh5",
@@ -389,21 +384,6 @@
         }
       ]
     },
-    {
-      "id": "I_kwDOFLhIt86ihL5I",
-      "title": "[BUG] voting summary has some errors in `isVotedInLast3Months`",
-      "isAssigned": false,
-      "resourcePath": "/asyncapi/community/issues/1614",
-      "repo": "asyncapi/community",
-      "author": "derberg",
-      "area": "javascript",
-      "labels": [
-        {
-          "name": "bug",
-          "color": "d73a4a"
-        }
-      ]
-    },
     {
       "id": "I_kwDODwv8N86f37o-",
       "title": "Return to top arrow feature/button",

markdown/docs/tools/generator/generator-template.md

@@ -122,7 +122,7 @@ Here's what is contained in the code snippet above:
   - **supportedProtocols** - A list that specifies which protocols are supported by your template.
 - **dependencies** - specifies which version of [`@asyncapi/generator-react-sdk`](https://github.com/asyncapi/generator-react-sdk) should be used.
 
-Navigate to the ****python-mqtt-client-template** directory. Run the command `npm install` on your terminal to install the dependencies specified in **package.json**.
+Navigate to the **python-mqtt-client-template** directory. Run the command `npm install` on your terminal to install the dependencies specified in **package.json**.
 
 ### index.js file
 
@@ -258,7 +258,7 @@ while True:
 
 ```
 
-Run the code above in your terminal using the command `python test.py`. You should see output similar to the snippet below logged on your terminal:
+Navigate to the **python-mqtt-client-template/test/project** directory. Run the command `python test.py` on your terminal. You should see output similar to the snippet below logged on your terminal:
 
 ``` cmd
 New temperature detected 64250266 sent to temperature/changed
@@ -298,18 +298,35 @@ class TemperatureServiceClient:
 
 ### 4. Write script to run the test code
 
-In **package.json** you can have the scripts property that you invoke by calling `npm run <your_script>`. Add these scripts to **package.json**:
+In **package.json** you can have the scripts property that you invoke by calling `npm run <your_script>`. After adding these scripts in **package.json**, it will look like the following code snippet:
 
 ``` json
-    "scripts": {
+    {
+      "name": "python-mqtt-client-template",
+      "version": "0.0.1",
+      "description": "A template that generates a Python MQTT client using MQTT.",
+      "scripts": {
         "test:clean": "rimraf test/project/client.py",
         "test:generate": "asyncapi generate fromTemplate test/fixtures/asyncapi.yml ./ --output test/project --force-write",
         "test:start": "python test/project/test.py",
         "test": "npm run test:clean && npm run test:generate && npm run test:start"
+      },
+      "generator": {
+        "renderer": "react",
+        "apiVersion": "v1",
+        "generator": ">=1.10.0 <2.0.0",
+        "supportedProtocols": ["mqtt"]
+      },
+      "dependencies": {
+        "@asyncapi/generator-react-sdk": "^0.2.25"
+      },
+      "devDependencies": {
+        "rimraf": "^5.0.0"
+      }
     }
 ```
 
-The 4 scripts above do the following:
+The 4 scripts added in **package.json** do the following:
 
 1. `test:clean`: This script uses the `rimraf` package to remove the old version of the file **test/project/client.py** every time you run your test.
 2. `test:generate`: This script uses the AsyncAPI CLI to generate a new version of **client.py**.
@@ -469,16 +486,16 @@ It's recommended to put reusable components outside the template directory in a
  * As input it requires a list of Channel models from the parsed AsyncAPI document
  */
 export function TopicFunction({ channels }) {
-  const topicsDetails = getTopics(channels)
-  let functions = ''
+  const topicsDetails = getTopics(channels);
+  let functions = '';
 
   topicsDetails.forEach((t) => {
     functions += `def send${t.name}(self, id):
         topic = "${t.topic}"
         self.client.publish(topic, id)\n`
-  })
+  });
 
-  return functions
+  return functions;
 }
 
 /*
@@ -489,19 +506,19 @@ export function TopicFunction({ channels }) {
  * As input it requires a list of Channel models from the parsed AsyncAPI document
  */
 function getTopics(channels) {
-  const channelsCanSendTo = channels
-  let topicsDetails = []
+  const channelsCanSendTo = channels;
+  let topicsDetails = [];
 
   channelsCanSendTo.forEach((ch) => {
-    const topic = {}
-    const operationId = ch.operations().filterByReceive()[0].id()
-    topic.name = operationId.charAt(0).toUpperCase() + operationId.slice(1)
-    topic.topic = ch.address()
+    const topic = {};
+    const operationId = ch.operations().filterByReceive()[0].id();
+    topic.name = operationId.charAt(0).toUpperCase() + operationId.slice(1);
+    topic.topic = ch.address();
 
-    topicsDetails.push(topic)
+    topicsDetails.push(topic);
   })
 
-  return topicsDetails
+  return topicsDetails;
 }
 ```
 

markdown/docs/tools/generator/installation-guide.md

@@ -8,7 +8,7 @@ You can use the generator library to generate whatever you want in your event-dr
 - [Generator library in Node.js apps](#generator-library-in-nodejs-apps)
 
 ## Prerequisites
-Before you install and use the AsyncAPI CLI and the generator library, ensure you meet the prerequisites below, then [install the CLI](#installation).
+Before you install and use the AsyncAPI CLI and the generator library, ensure you meet the prerequisites below, then [install the CLI](https://www.asyncapi.com/docs/tools/cli/installation).
 1. Node.js v18.12.0 or higher
 2. Npm v8.19.0 or higher
 
@@ -27,7 +27,7 @@ If you have the correct versions installed, proceed to the CLI installation guid
 ## AsyncAPI CLI
 The AsyncAPI CLI tool allows you to do many different things with the [AsyncAPI document](asyncapi-document). You can generate message-based API boilerplate code, documentation, or anything else you need as long as you specify it in your [template](template) or the existing template already supports it. To use the generator via the AsyncAPI CLI, you need to install the AsyncAPI CLI tool. For the latest installation instructions, visit the official AsyncAPI CLI [installation guide](https://www.asyncapi.com/docs/tools/cli/installation).
 
-> :memo: **Note:**  To use the generator in your CI/CD pipeline to automate whatever you generate for your event-driven architecture apps, install the AsyncAPI CLI in your pipeline. If you are using GitHub Actions, use [Github Actions for Generator](https://github.com/marketplace/actions/generator-for-asyncapi-documents).
+> :memo: **Note:**  To use the generator in your CI/CD pipeline to automate whatever you generate for your event-driven architecture apps, install the AsyncAPI CLI in your pipeline. If you are using GitHub Actions, use [Github Actions for Generator](https://github.com/marketplace/actions/asyncapi-cli-action).
 
 ## Generator library in Node.js apps
 Use the generator library in your Node.js projects by installing it via the following command: `npm install @asyncapi/generator`.

markdown/docs/tools/generator/usage.md

@@ -94,12 +94,14 @@ Install [Docker](https://docs.docker.com/get-docker/) first, then use docker to
 
 ```bash
 docker run --rm -it \
+--user=root \
 -v [ASYNCAPI SPEC FILE LOCATION]:/app/asyncapi.yml \
 -v [GENERATED FILES LOCATION]:/app/output \
-asyncapi/cli [COMMAND HERE]
+asyncapi/cli # docker image [COMMAND HERE]
 
 # Example that you can run inside the cli directory after cloning this repository. First, you specify the mount in the location of your AsyncAPI specification file and then you mount it in the directory where the generation result should be saved.
 docker run --rm -it \
+   --user=root \
    -v ${PWD}/test/fixtures/asyncapi_v1.yml:/app/asyncapi.yml \
    -v ${PWD}/output:/app/output \
    asyncapi/cli generate fromTemplate -o /app/output /app/asyncapi.yml @asyncapi/[email protected] --use-new-generator --force-write