Skip to content

docs(community): update latest community documentation#4404

Closed
asyncapi-bot wants to merge 1 commit intomasterfrom
update-community-docs-5c33f2092a7efc73260b656e65200344deac772a
Closed

docs(community): update latest community documentation#4404
asyncapi-bot wants to merge 1 commit intomasterfrom
update-community-docs-5c33f2092a7efc73260b656e65200344deac772a

Conversation

@asyncapi-bot
Copy link
Contributor

@asyncapi-bot asyncapi-bot commented Sep 9, 2025

Updated community documentation is available and this PR introduces update to community folder on the website

Summary by CodeRabbit

  • Documentation
    • Updated Meeting/Streaming guide with clearer Zoom/Restream/YouTube steps and refined labels.
    • Added descriptive alt text to all images and standardized image assets for improved accessibility.
    • Reworked “Provide title and description” into clearer bullets, including adding a thumbnail.
    • Reordered Restream-first guidance with clearer instructions, including starting with YouTube.
    • Introduced explicit post-meeting steps for follow-up.
    • Removed extensive podcast publishing content to streamline the guide.
    • Applied minor formatting and consistency improvements throughout.

@netlify
Copy link

netlify bot commented Sep 9, 2025

Deploy Preview for asyncapi-website failed.

Name Link
🔨 Latest commit 395c82e
🔍 Latest deploy log https://app.netlify.com/projects/asyncapi-website/deploys/68bff725548a9900080381e1

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Sep 9, 2025

Walkthrough

Documentation for organizing meetings and live streaming was updated: revised Zoom/Restream/YouTube steps, replaced/renamed images with alt text, restructured “Provide title and description,” reordered Restream-first guidance, added post-meeting steps, and removed podcast publication content.

Changes

Cohort / File(s) Summary of Changes
Docs: Meetings & Streaming workflow
markdown/docs/community/060-meetings-and-communication/MEETINGS_ORGANIZATION.md
Updated Zoom-first and Restream-first flows; renamed image assets (restreamX.pngstreamX.png) and added descriptive alt text; reworked title/description section including thumbnail step; added explicit YouTube-first note; standardized labels; added post-meeting steps; removed podcast-related sections; formatting/accessibility tweaks throughout.

Sequence Diagram(s)

sequenceDiagram
  autonumber
  actor Host
  participant Zoom
  participant Restream
  participant YouTube

  Note over Host,YouTube: Zoom-first streaming flow
  Host->>Zoom: Start meeting and enable live streaming
  Zoom->>Restream: Stream via Encoder/RTMP
  Restream->>YouTube: Forward stream to channel
  Host->>YouTube: Set title, description, thumbnail
  YouTube-->>Host: Live Control Room & captions
  Note right of YouTube: Post-meeting: end stream and finalize

  %% Style notes
  rect rgba(227, 242, 253, 0.4)
  Note over Zoom,Restream: Encoder/RTMP option name updated
  end
Loading
sequenceDiagram
  autonumber
  actor Host
  participant Restream
  participant Zoom
  participant YouTube

  Note over Host,YouTube: Restream-first streaming flow
  Host->>YouTube: Create event (Go Live) first
  Host->>Restream: Configure destinations incl. YouTube
  Restream->>Zoom: Provide RTMP info for Zoom
  Host->>Zoom: Start meeting, stream to custom RTMP
  Zoom->>Restream: Send stream
  Restream->>YouTube: Distribute stream
  YouTube-->>Host: Monitor, enable captions
Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested labels

autoapproved, autoupdate

Suggested reviewers

  • quetzalliwrites
  • thulieblack
  • TRohit20
  • VaishnaviNandakumar
  • asyncapi-bot-eve

Pre-merge checks (1 passed, 2 inconclusive)

❌ Failed checks (2 inconclusive)
Check name Status Explanation Resolution
Title Check ❓ Inconclusive The current title follows a conventional commit style and indicates that documentation has been updated, but it is overly generic and does not specify the key updates or focus areas introduced by the changeset. Consider renaming the PR to succinctly reflect the main change, for example "docs(community): enhance meetings livestream workflow and improve accessibility".
Description Check ❓ Inconclusive The description acknowledges updates to the community documentation but remains very high-level and lacks any details about the specific sections or improvements made. Expand the description to summarize key changes such as the Zoom/Restream workflow updates, improved image alt text, and removal of podcast sections for clearer context to reviewers.
✅ Passed checks (1 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.

Poem

I hopped through docs with keen delight,
Swapped pics for words that shine so bright.
Streams align—Zoom to Restream’s tune,
YouTube awaits, we’re live by noon!
Podcasts burrowed out of sight—
Thumbnails nibble, captions light.
Thump-thump—ship it, streaming right! 🐇📡🎬

Tip

👮 Agentic pre-merge checks are now available in preview!

Pro plan users can now enable pre-merge checks in their settings to enforce checklists before merging PRs.

  • Built-in checks – Quickly apply ready-made checks to enforce title conventions, require pull request descriptions that follow templates, validate linked issues for compliance, and more.
  • Custom agentic checks – Define your own rules using CodeRabbit’s advanced agentic capabilities to enforce organization-specific policies and workflows. For example, you can instruct CodeRabbit’s agent to verify that API documentation is updated whenever API schema files are modified in a PR. Note: Upto 5 custom checks are currently allowed during the preview period. Pricing for this feature will be announced in a few weeks.

Example:

reviews:
  pre_merge_checks:
    custom_checks:
      - name: "Undocumented Breaking Changes"
        mode: "warning"
        instructions: |
          Pass/fail criteria: All breaking changes to public APIs, CLI flags, environment variables, configuration keys, database schemas, or HTTP/GraphQL endpoints must be documented in the "Breaking Change" section of the PR description and in CHANGELOG.md. Exclude purely internal or private changes (e.g., code not exported from package entry points or explicitly marked as internal).

Please share your feedback with us on this Discord post.

✨ Finishing Touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch update-community-docs-5c33f2092a7efc73260b656e65200344deac772a

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@codecov
Copy link

codecov bot commented Sep 9, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (1991a70) to head (395c82e).

Additional details and impacted files
@@            Coverage Diff            @@
##            master     #4404   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           22        22           
  Lines          778       778           
  Branches       144       144           
=========================================
  Hits           778       778           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (2)
markdown/docs/community/060-meetings-and-communication/MEETINGS_ORGANIZATION.md (2)

84-86: Complete the unfinished sentence explaining why YouTube must be first.

The paragraph ends abruptly (“It is because by”). Suggest a concise rationale.

Apply:

-You must start with YouTube first, even though Restream can directly stream there. It is because by 
-This is what you need to do to kick it off:
+You must start with YouTube first, even though Restream can stream directly to YouTube. This ensures you can enable Closed Captions and set event metadata on YouTube; then select this event in Restream (do not create a new one).
+
+This is what you need to do to kick it off:

50-132: Add missing image assets referenced in MEETINGS_ORGANIZATION.md
All 18 images under markdown/docs/community/assets/meetings/ referenced in markdown/docs/community/060-meetings-and-communication/MEETINGS_ORGANIZATION.md are missing and will break the documentation. Add these files at the referenced paths.

🧹 Nitpick comments (3)
markdown/docs/community/060-meetings-and-communication/MEETINGS_ORGANIZATION.md (3)

60-65: Add thumbnail guidance (size/aspect) to reduce guesswork.

Consider:

    - Add a thumbnail for the stream, as platforms like YouTube require one.
+   - Use a 16:9 thumbnail (for example, 1280×720) for best results.

139-141: “Log in” vs “Login”.

Use verb form.

-1. Login to YouTube and add the recorded live stream to the respective YouTube Playlist.
+1. Log in to YouTube and add the recorded live stream to the respective YouTube Playlist.

167-167: Spelling: “Committee”.

-... Technical Steering Commitee ...
+... Technical Steering Committee ...
📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 1991a70 and 395c82e.

📒 Files selected for processing (1)
  • markdown/docs/community/060-meetings-and-communication/MEETINGS_ORGANIZATION.md (2 hunks)
⏰ Context from checks skipped due to timeout of 180000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (3)
  • GitHub Check: Automerge PR autoapproved by a bot
  • GitHub Check: Lighthouse CI
  • GitHub Check: Test NodeJS PR - windows-latest
🔇 Additional comments (2)
markdown/docs/community/060-meetings-and-communication/MEETINGS_ORGANIZATION.md (2)

56-57: LGTM: clearer “Update Titles” illustration with alt text.


68-81: Alt text and image swaps improve accessibility and clarity.

The updated images + descriptive alt text across Zoom/YouTube/Restream steps look good.

Also applies to: 90-99, 100-103, 106-111, 116-128

Comment on lines +50 to 53
1. Log into [Restream.io](https://app.restream.io/home) and select `Encoder|RMTP (Stream from OBS,Zoom,VMix,etc.)` option:

<img src="../../assets/meetings/restream1.png" width="50%" />
<img src="../../assets/meetings/stream1.png" width="50%" alt="Restream: Encoder | RTMP option selected"/>

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

Fix RTMP label, spacing, and brand casing in Restream step.

Typo and minor formatting: “RMTP” → “RTMP”, add spaces around “|” and commas, and use “vMix”.

Apply:

-1. Log into [Restream.io](https://app.restream.io/home) and select `Encoder|RMTP (Stream from OBS,Zoom,VMix,etc.)` option:
+1. Log into [Restream.io](https://app.restream.io/home) and select `Encoder | RTMP (Stream from OBS, Zoom, vMix, etc.)` option:
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
1. Log into [Restream.io](https://app.restream.io/home) and select `Encoder|RMTP (Stream from OBS,Zoom,VMix,etc.)` option:
<img src="../../assets/meetings/restream1.png" width="50%" />
<img src="../../assets/meetings/stream1.png" width="50%" alt="Restream: Encoder | RTMP option selected"/>
1. Log into [Restream.io](https://app.restream.io/home) and select `Encoder | RTMP (Stream from OBS, Zoom, vMix, etc.)` option:
<img src="../../assets/meetings/stream1.png" width="50%" alt="Restream: Encoder | RTMP option selected"/>
🤖 Prompt for AI Agents
In
markdown/docs/community/060-meetings-and-communication/MEETINGS_ORGANIZATION.md
around lines 50–53, fix the typo and formatting in the Restream step: change
"RMTP" to "RTMP", add spaces around the pipe so it reads "Encoder | RTMP", add
spaces after commas and before "etc.", and use the correct brand casing "vMix"
(e.g., "Encoder | RTMP (Stream from OBS, Zoom, vMix, etc.)"); update the inline
text and any corresponding alt text if it contains the same mistakes.

Comment on lines +131 to 132
<img src="../../assets/meetings/restream7.png" width="40%" alt="Restream: Create event />

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

Fix malformed tag and align alt text with guidance.

Unclosed quote in alt attribute; also alt suggests creating a new event, which contradicts the instructions.

Apply:

-    <img src="../../assets/meetings/restream7.png" width="40%" alt="Restream: Create event />
+    <img src="../../assets/meetings/restream7.png" width="40%" alt="Restream: Select existing YouTube event" />
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
<img src="../../assets/meetings/restream7.png" width="40%" alt="Restream: Create event />
<img src="../../assets/meetings/restream7.png" width="40%" alt="Restream: Select existing YouTube event" />
🤖 Prompt for AI Agents
In
markdown/docs/community/060-meetings-and-communication/MEETINGS_ORGANIZATION.md
around lines 131-132, the <img> tag is malformed (missing closing quote and
closing bracket) and the alt text contradicts the instructions; fix the tag by
closing the src/alt attribute quotes and the tag itself (e.g., ...
alt="Restream: Events page" />), and change the alt text to a neutral, accurate
description such as "Restream: Events page" (or another text that matches the
guidance) so the image is well-formed and the alt copy aligns with the document
intent.

@thulieblack
Copy link
Member

@ezinneanne

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants