Đóng góp cho SubQuery

... 2022-8-15 Khoảng 3 phút

# Đóng góp cho SubQuery

Chào mừng và chân thành cảm ơn bạn đã cân nhắc đóng góp cho dự án SubQuery! Cùng nhau, chúng ta có thể mở đường cho một tương lai phi tập trung hơn.

Tài liệu này được duy trì tích cực bởi nhóm SubQuery. Chúng tôi hoan nghênh những đóng góp của bạn, bạn có thể làm như vậy bằng cách nhân bản dự án GitHub của chúng tôi và thực hiện các thay đổi đối với tất cả các tệp đánh dấu tài liệu trong thư mục docs.

Sau đây là một tập hợp các nguyên tắc (không phải quy tắc) để đóng góp vào SubQuery. Việc tuân theo các nguyên tắc này sẽ giúp chúng tôi thực hiện quá trình đóng góp dễ dàng và hiệu quả cho tất cả mọi người tham gia. Nó cũng thông báo rằng bạn đồng ý tôn trọng thời gian của các nhà phát triển quản lý và phát triển dự án này. Đổi lại, chúng tôi sẽ đáp lại sự tôn trọng đó bằng cách giải quyết vấn đề của bạn, xem xét các thay đổi, cộng tác để cải tiến và giúp bạn hoàn thiện các pull requests của bạn.

# Quy tắc ứng xử

Chúng tôi coi trọng trách nhiệm và các dự án cộng đồng mã nguồn mở của mình, đồng thời giữ bản thân và những người đóng góp khác tuân theo các tiêu chuẩn cao về giao tiếp. Bằng cách tham gia và đóng góp vào dự án này, bạn đồng ý tuân thủ Quy tắc ứng xử (opens new window) của chúng tôi.

# Bắt đầu

Sự đóng góp vào tệp mã nguồn của chúng tôi được thực hiện thông qua Issues và Pull Requests (PR). Một số nguyên tắc chung bao gồm cả hai điều sau:

  • Tìm kiếm các Vấn đề và PR hiện có trước khi tự làm.
  • Chúng tôi làm việc chăm chỉ để đảm bảo các vấn đề được xử lý kịp thời nhưng tùy thuộc vào mức độ ảnh hưởng, có thể mất một khoảng thời gian để điều tra nguyên nhân gốc rễ. Đề cập @ thân thiện trong chuỗi nhận xét cho người gửi hoặc người đóng góp có thể giúp thu hút sự chú ý nếu vấn đề của bạn đang bị chặn.

# Cách đóng góp

# Báo cáo lỗi

Lỗi được theo dõi là sự cố GitHub. Khi ghi nhật ký sự cố, hãy giải thích sự cố và bao gồm các chi tiết bổ sung để giúp người bảo trì tái tạo sự cố:

  • Sử dụng tiêu đề rõ ràng và mang tính mô tả cho vấn đề để xác định vấn đề.
  • Mô tả các bước chính xác để tái tạo vấn đề.
  • Mô tả trạng thái bạn đã quan sát được sau khi làm theo các bước.
  • Giải thích hành vi nào bạn muốn thấy và tại sao.
  • Bao gồm ảnh chụp màn hình nếu có thể.

# Gửi Pull Requests

Nói chung, chúng tôi tuân theo quy trình làm việc Git "fork-and-pull"

  • Chuyển tập mã nguồn vào tài khoản Github của riêng bạn
  • Sao chép dự án vào máy của bạn
  • Tạo một nhánh cục bộ với tên ngắn gọn nhưng mô tả đầy đủ
  • Commit các thay đổi đối với nhánh
  • Tuân theo mọi nguyên tắc định dạng và kiểm tra cụ thể cho tập mã nguồn này
  • Đẩy các thay đổi đối với nhánh của bạn
  • Mở một PR trong tập mã nguồn của chúng tôi

# Quy ước mã hóa

# Thông báo cam kết Git

  • Sử dụng thì hiện tại ("Thêm tính năng" không phải "Đã thêm tính năng")
  • Sử dụng mệnh lệnh thức ("Move cursor to..." not "Moves cursor to...")
  • Giới hạn dòng đầu tiên trong vòng 72 ký tự trở xuống

# Hướng dẫn định kiểu JavaScript

  • Tất cả mã JavaScript được in bằng Prettier và ESLint
Cập nhật gần nhất lúc: August 15, 2022 23:43