Skip to content

docs(contributing): add base-branch callout so PRs target dev#240

Open
prakashUXtech wants to merge 1 commit into
devfrom
docs/contributing-base-branch-callout
Open

docs(contributing): add base-branch callout so PRs target dev#240
prakashUXtech wants to merge 1 commit into
devfrom
docs/contributing-base-branch-callout

Conversation

@prakashUXtech
Copy link
Copy Markdown
Contributor

@prakashUXtech prakashUXtech commented May 13, 2026

What this changes

Both LFDT mentee PRs in this cohort (#232, #237) opened against main instead of dev. The dev-vs-main rule was in CONTRIBUTING.md but buried as one bullet inside "Submitting a PR" alongside Conventional Commits and lint. A skim of the PR template missed it entirely.

Two surgical adds:

  1. Callout block at the top of CONTRIBUTING.md: a GitHub-flavoured > [!IMPORTANT] admonition right after the doc heading, before Quick Start. Includes the starter command for branching off dev.
  2. First checklist item in .github/PULL_REQUEST_TEMPLATE.md: "Base branch is dev, not main" with a link back to CONTRIBUTING.md. This is the one a contributor sees in the PR compose form before they hit submit.

No code change. No test impact.

How to test

Visual review: the callout renders correctly on github.com (GitHub admonition syntax). The PR template change appears in the compose form for the next PR.

Both LFDT mentee PRs in this cohort (#232, #237) opened against `main`
instead of `dev`. The rule was in CONTRIBUTING.md but buried as one
bullet inside "Submitting a PR" alongside Conventional Commits and lint.
Mentees who skim only the PR template never saw it.

Two adds:

1. Callout block at the top of CONTRIBUTING.md (GitHub-flavoured
   `> [!IMPORTANT]` admonition) so it appears between the doc heading
   and Quick Start, and shows a starter command for branching off dev.

2. New first checklist item in PULL_REQUEST_TEMPLATE.md: "Base branch
   is `dev`, not `main`" linking back to CONTRIBUTING.md. This is the
   one a contributor actually sees in the PR compose form.

No code change.
@github-actions
Copy link
Copy Markdown

Issues (must fix)

  • No evidence of local testing found. Please include terminal output or screenshots.

Heads up

  • This PR touches sensitive files (CI/CD workflows). These paths require maintainer review via CODEOWNERS.

Please update your PR to address these points.

@github-actions
Copy link
Copy Markdown

This PR has been automatically marked as stale because it has not had activity in the last 14 days. It will be closed in 7 days if no further activity occurs. If you're still working on this, please push an update or leave a comment.

@github-actions github-actions Bot added the stale label May 27, 2026
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jun 3, 2026

Closing due to inactivity. If you'd like to continue, please open a new PR.

@github-actions github-actions Bot closed this Jun 3, 2026
@prakashUXtech prakashUXtech reopened this Jun 3, 2026
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.

1 participant