Skip to content

docs(community): fix broken git workflow link in welcome message#2201

Closed
Harsh16gupta wants to merge 0 commit intoasyncapi:masterfrom
Harsh16gupta:master
Closed

docs(community): fix broken git workflow link in welcome message#2201
Harsh16gupta wants to merge 0 commit intoasyncapi:masterfrom
Harsh16gupta:master

Conversation

@Harsh16gupta
Copy link
Contributor

@Harsh16gupta Harsh16gupta commented Dec 29, 2025

Description

This PR fixes a broken link in the GitHub Actions welcome message shown to first-time contributors by pointing it to the correct Git Workflow document.

Context

The welcome message includes a link to the “basic recommended setup”.

0b050950-374b-42f8-8829-e882220e0bf2

Problem (Before)

Clicking the link currently leads to a 404 page because the document was moved.

bf0627b0-c3a7-4d39-8300-a9c5cf04e409

Correct Location (After)

The Git Workflow document exists at the following path:

community/docs/010-contribution-guidelines/git-workflow.md

d38e53ce-ae3c-496d-b171-fdbe317c6ddc

Impact

  • Improves contributor onboarding experience
  • Prevents confusion caused by broken documentation links
  • No breaking changes

Summary by CodeRabbit

  • Chores
    • Updated welcome messages for first-time contributors with improved guidance references and more specific pull request messaging.

✏️ Tip: You can customize this high-level summary in your review settings.

Copy link

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

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

Welcome to AsyncAPI. Thanks a lot for creating your first pull request. Please check out our contributors guide useful for opening a pull request.
Keep in mind there are also other channels you can use to interact with AsyncAPI community. For more details check out this issue.

@coderabbitai
Copy link

coderabbitai bot commented Dec 29, 2025

📝 Walkthrough

Walkthrough

Updated a GitHub Actions workflow that displays welcome messages to first-time contributors. The issueMessage now references a more specific documentation path (docs/010-contribution-guidelines/git-workflow.md), and the prMessage explicitly mentions "first pull request" with adjusted wording.

Changes

Cohort / File(s) Summary
GitHub Actions Workflows
.github/workflows/welcome-first-time-contrib.yml
Updated welcome message content and documentation path references; issueMessage now points to nested documentation structure; prMessage clarified to explicitly mention "first pull request"

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 A path made clear, a welcome so bright,
First-timers guided with updated light,
From shallow references to docs deep and true,
We hop ahead with refreshed view!

Pre-merge checks

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs(community): fix broken git workflow link in welcome message' directly describes the main change: fixing a broken documentation link in the welcome message workflow file.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

📜 Recent review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 4d662e8 and 615f87c.

📒 Files selected for processing (1)
  • .github/workflows/welcome-first-time-contrib.yml
🧰 Additional context used
🧠 Learnings (1)
📓 Common learnings
Learnt from: thulieblack
Repo: asyncapi/community PR: 1730
File: docs/onboarding-guide/contribution-flow.md:1-4
Timestamp: 2025-04-29T11:49:47.903Z
Learning: In the asyncapi/community repository, `docs/onboarding-guide/contribution-flow.md` is the correct path for contribution flow documentation, not `docs/community/onboarding-guide/contribution-flow.md`.
🔇 Additional comments (2)
.github/workflows/welcome-first-time-contrib.yml (2)

25-25: Note: AI summary inconsistency detected.

The AI-generated summary mentions that the prMessage was modified to explicitly mention "first pull request" with adjusted wording. However, this line shows no change marker (~) in the annotated code, suggesting either:

  1. The text already contained "first pull request" before this PR
  2. The AI summary is inaccurate about changes to this line

This doesn't affect the validity of the fix, but it's worth noting the discrepancy.


24-24: The path in the workflow is correct; the file exists at docs/010-contribution-guidelines/git-workflow.md and the link will function properly.


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.

Copy link

@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: 0

Caution

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

⚠️ Outside diff range comments (1)
.github/workflows/welcome-first-time-contrib.yml (1)

1-2: This file is centrally managed and changes here will be overwritten.

The file is synchronized from https://github.com/asyncapi/.github/ (confirmed by git history with recent sync at commit 26bac91). Any changes made to this file in this repository will be lost when the next synchronization occurs.

To fix the broken link reference on line 24, you must make the corresponding change in the central .github repository at https://github.com/asyncapi/.github/ instead. This ensures the fix is preserved and propagates to all synchronized repositories.

📜 Review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 4d662e8 and 615f87c.

📒 Files selected for processing (1)
  • .github/workflows/welcome-first-time-contrib.yml
🧰 Additional context used
🧠 Learnings (1)
📓 Common learnings
Learnt from: thulieblack
Repo: asyncapi/community PR: 1730
File: docs/onboarding-guide/contribution-flow.md:1-4
Timestamp: 2025-04-29T11:49:47.903Z
Learning: In the asyncapi/community repository, `docs/onboarding-guide/contribution-flow.md` is the correct path for contribution flow documentation, not `docs/community/onboarding-guide/contribution-flow.md`.
🔇 Additional comments (2)
.github/workflows/welcome-first-time-contrib.yml (2)

25-25: Note: AI summary inconsistency detected.

The AI-generated summary mentions that the prMessage was modified to explicitly mention "first pull request" with adjusted wording. However, this line shows no change marker (~) in the annotated code, suggesting either:

  1. The text already contained "first pull request" before this PR
  2. The AI summary is inaccurate about changes to this line

This doesn't affect the validity of the fix, but it's worth noting the discrepancy.


24-24: The path in the workflow is correct; the file exists at docs/010-contribution-guidelines/git-workflow.md and the link will function properly.

Copy link
Member

@derberg derberg left a comment

Choose a reason for hiding this comment

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

@bandantonio
Copy link
Collaborator

bandantonio commented Jan 5, 2026

@bandantonio shouldn't we link to website version? https://www.asyncapi.com/docs/community/010-contribution-guidelines/git-workflow

@derberg Yes, you're right. I haven't spotted the base url part right away.

Copy link
Collaborator

@bandantonio bandantonio left a comment

Choose a reason for hiding this comment

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

The link should lead the web version of the document.

@Harsh16gupta
Copy link
Contributor Author

@bandantonio @derberg My bad! I made a mistake by opening this PR from my master branch which has merge commits. I've created a clean branch with only the fix. Can I close this and open a new PR from the clean branch with the correct website link: https://www.asyncapi.com/docs/community/010-contribution-guidelines/git-workflow

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants