کمک به بازل

راه های زیادی برای کمک به پروژه و اکوسیستم بازل وجود دارد.

ارائه بازخورد

همانطور که از Bazel استفاده می کنید، ممکن است مواردی را پیدا کنید که می توان آنها را بهبود بخشید. در موارد زیر می توانید با گزارش مشکلات کمک کنید:

  • Bazel خراب می شود یا با یک اشکال مواجه می شوید که فقط با استفاده از bazel clean قابل حل است.
  • مستندات ناقص یا نامشخص است. همچنین می توانید با استفاده از پیوند "ایجاد مشکل" در گوشه سمت راست بالای صفحه، مشکلات را از صفحه ای که مشاهده می کنید گزارش کنید.
  • یک پیام خطا می تواند بهبود یابد.

در اجتماع شرکت کنید

شما می توانید با انجمن بازل در ارتباط باشید:

  • پاسخ به سؤالات Stack Overflow .
  • کمک به سایر کاربران در Slack .
  • بهبود مستندات یا ارائه مثال‌ها .
  • به اشتراک گذاری تجربیات یا نکات خود، به عنوان مثال، در یک وبلاگ یا رسانه های اجتماعی.

کد مشارکت

Bazel یک پروژه بزرگ است و ایجاد تغییر در کد منبع Bazel می تواند دشوار باشد.

شما می توانید از طریق موارد زیر به اکوسیستم بازل کمک کنید:

  • کمک به نگهبانان قوانین با مشارکت در درخواست‌های کشش.
  • ایجاد قوانین جدید و منبع باز آنها.
  • کمک به ابزارهای مرتبط با Bazel، به عنوان مثال، ابزارهای مهاجرت.
  • بهبود ادغام Bazel با سایر IDE ها و ابزارها.

قبل از ایجاد تغییر، یک مشکل GitHub ایجاد کنید یا به bazel-dev@ ایمیل بزنید.

کمک‌کننده‌ترین مشارکت‌ها اشکالات را برطرف می‌کنند یا ویژگی‌هایی را اضافه می‌کنند (برخلاف تغییرات سبک، بازسازی یا «پاک‌سازی»). تغییر شما باید شامل آزمایش‌ها و مستندات باشد، با در نظر گرفتن سازگاری با گذشته، قابل حمل بودن، و تأثیر بر استفاده و عملکرد حافظه.

برای آشنایی با نحوه ارسال تغییر، به فرآیند پذیرش پچ مراجعه کنید.

توضیحات کد بازل

Bazel یک پایگاه کد بزرگ با کد در چندین مکان دارد. برای جزئیات بیشتر به راهنمای پایگاه کد مراجعه کنید.

بازل به شرح زیر سازماندهی شده است:

  • کد کلاینت در src/main/cpp است و رابط خط فرمان را فراهم می کند.
  • بافرهای پروتکل در src/main/protobuf هستند.
  • کد سرور به صورت src/main/java و src/test/java می باشد.
    • کد اصلی که بیشتر از SkyFrame و برخی ابزارهای کمکی تشکیل شده است.
    • قوانین داخلی در com.google.devtools.build.lib.rules و در com.google.devtools.build.lib.bazel.rules هستند. شاید بخواهید ابتدا در مورد چالش های قوانین نوشتن بخوانید.
  • رابط های بومی جاوا در src/main/native هستند.
  • ابزارهای مختلف برای پشتیبانی از زبان در لیست در بخش کامپایل Bazel توضیح داده شده است.

جستجوی کد منبع Bazel

برای جستجوی سریع کد منبع Bazel، از جستجوی کد Bazel استفاده کنید. می توانید در مخازن، شاخه ها و فایل های Bazel حرکت کنید. همچنین می توانید تاریخچه، تفاوت ها و اطلاعات سرزنش را مشاهده کنید. برای کسب اطلاعات بیشتر، به راهنمای کاربر جستجوی کد Bazel مراجعه کنید.