docs(framework): explain how a contributor without push access opens a pull request

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#1,117 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@sadhana-s-codez đang làm issue này rồi.

Từ ngày 28/10/2026.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
76/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
markdown
Lĩnh vực
documentation

Hướng nghiên cứu

Đọc phần “Open a pull request” của CONTRIBUTING.md cùng với các phần “Setup” và “Branches” của aidd_docs/memory/vcs.md, và so sánh các target setup, doctor, check và reload trong Makefile để xem chúng có giả định quyền push hay không. Viết quy trình fork (fork, clone, thêm upstream, tạo nhánh từ next, push lên fork, nhắm đến next) vào cả hai tệp. Hoàn tất nghĩa là hai tệp nêu cùng một quy tắc nhánh cơ sở và node scripts/check-markdown-links.js chạy qua trên các tệp đã thay đổi.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Problem

CONTRIBUTING.md takes a contributor from "Get it validated" to "Open your PR" with one instruction: "Branch off next, target next". It never says what a contributor without write access to ai-driven-dev/framework does to get there. A search for "fork", "write access" and "push access" in CONTRIBUTING.md, GOVERNANCE.md, .github/PULL_REQUEST_TEMPLATE.md and README.md returns nothing.

A community member reported during a community call that they could not open a pull request for a small slides update because they lacked the rights, and stopped at filing two issues. The issue-first path works; the missing step is how a non-maintainer goes from a validated issue to a pull request.

Scope
  • Add a short path for contributors without write access to the "Open a pull request" section of CONTRIBUTING.md: fork, clone, add upstream, branch off next, push to the fork, open the PR against next of ai-driven-dev/framework.
  • Check that make setup, make doctor, make check and make reload run from a fork clone, and state any difference.
  • Give the fork variant of gh pr create where aidd_docs/memory/vcs.md describes the base branch.
Acceptance criteria
  • CONTRIBUTING.md states what a contributor without push access does between "Set up" and "Open a pull request", without leaving the page.
  • Starting from a validated issue and a fork, the documented commands alone lead to an open pull request targeting next.
  • make setup, make doctor, make check and make reload are confirmed to run from a fork clone, or the differences are documented.
  • CONTRIBUTING.md and aidd_docs/memory/vcs.md give the same base-branch rule.
  • node scripts/check-markdown-links.js passes on the changed files.
Prior art in this repo
  • CONTRIBUTING.md, "Open a pull request": branch off next, no fork step.
  • GOVERNANCE.md, roles table: Certified Members validate issues, Maintainers approve and merge.
  • aidd_docs/memory/vcs.md, "Setup" and "Branches": gh pr create without --base next targets production.
  • Makefile: setup, doctor, check, reload already exist.
  • #1114 plans an issue skill, which covers creating issues, not pull requests.
  • #928 covers which validation commands a plan carries, not contributor access.
Out of scope
  • A contributor skill or plugin that automates fork, branch and pull request, and whether it lives in the repository's own .claude/skills or in a marketplace plugin. Not decided; #1114 covers the user-facing skills.
  • Granting write access to contributors: a governance decision, see GOVERNANCE.md.
Ngôn ngữ chính
TypeScript
Star
481
Fork
45
Merge trung bình
1 ngày 2 giờ
Pull request đã merge (30 ngày)
105

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của ai-driven-dev/framework

Tất cả issue của ai-driven-dev/framework

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.