[📑 Docs]: Adapt Streetlights - Interactive tutorial for v3

[jonaslagoni]

For AsyncAPI v3, we need to adapt the streetlights interactive tutorial (https://www.asyncapi.com/docs/tutorials/streetlights-interactive) to be usable with AsyncAPI v3.

Make sure you base your change on the next-major-spec branch and target it in your PR 🙂 If you have any questions, don't hesitate to ask.

---

TASKS

We need to replace this old content with the new 4 tutorials we made last year, making them interactive:

• docs: create an AsyncAPI document (interactive version) - adapt for v3  #1869
• docs: generate code (interactive version) - adapt for v3 #1870
• docs: validate document with studio (interactive version) - adapt for v3 #1871
• docs: validate messages (interactive version) - adapt for v3 #1872

[jonaslagoni]

@alequetzalli I have no idea what tasks are needed to achieve this and to mark this as a good first issue, can you help pinpoint that?

[derberg]

this is the topic I mentioned on the call. Must have is migration of nodejs template 🤷🏼 or as @fmvilas mentioned on the call (while selling his idea that code generation is bad) it can be modified to use glee (once migrated)

tbh, the best if we have 2 tutorials, that show code generation scenario, and asyncapi-as-config scenario 🤷🏼

one of my mentorship ideas is rewrite nodejs templates to react enginee, and during the works I want to push for adding v3 support during rewrite. I will make sure first rewrite will happen to the nodejs template used in the tutorial

[jonaslagoni]

Is there anything that can be done in parallel, or is this issue blocked by asyncapi/nodejs-template#215?

[derberg]

well, in parallel maybe somebody could work on glee version of the tutorial maybe 🤔

[quetzalliwrites]

Quick reminder on staying within roadmap scope:

I don't think we should be focusing on adapting this outdated tutorial to V3 because this tutorial was always meant to be replaced by the 4 tutorials we made in 2022 GSoD. The plan was always to repurpose those 4 new tutorials into an interactive version to replace this interactive streetlights.

[quetzalliwrites]

/good-first-issue area/docs

[asyncapi-bot]

Hey @alequetzalli, your message doesn't follow the requirements, you can try /help.

[quetzalliwrites]

I fail at botting 😂

[quetzalliwrites]

@alequetzalli I have no idea what tasks are needed to achieve this and to mark this as a good first issue, can you help pinpoint that?

@jonaslagoni Yes! We need to replace this old content with the new 4 tutorials we made last year, making them interactive:

1. Create an AsyncAPi document: https://www.asyncapi.com/docs/tutorials/create-asyncapi-document
2. Generate code: https://www.asyncapi.com/docs/tutorials/generate-code
3. Validate document (with Studio): https://www.asyncapi.com/docs/tutorials/studio-document-validation
4. Validate messages: https://www.asyncapi.com/docs/tutorials/message-validation

I have updated your description in THIS issue and have created the required 4 subtasks.

[derberg]

@alequetzalli you just say docs not area/docs when you talk to the bot

[github-actions]

This issue has been automatically marked as stale because it has not had recent activity 😴

It will be closed in 120 days if no further activity occurs. To unstale this issue, add a comment with a detailed explanation.

There can be many reasons why some specific issue has no activity. The most probable cause is lack of time, not lack of interest. AsyncAPI Initiative is a Linux Foundation project not owned by a single for-profit company. It is a community-driven initiative ruled under open governance model.

Let us figure out together how to push this issue forward. Connect with us through one of many communication channels we established here.

Thank you for your patience ❤️

[derberg]

done and merged