برچسب ها را صادر کنید

برچسب‌ها یکی از ویژگی‌های جالب گیت‌هاب هستند که به شما امکان می‌دهند مشکلات را فیلتر کنید و درخواست‌ها را دریافت کنید. آن‌ها به شما کمک می‌کنند تا چیزی سرگرم‌کننده برای کار کردن پیدا کنید که با سطح تجربه شما مطابقت داشته باشد.

برای مخازن ما، اضافه کردن برچسب‌های جدید به مسائل منحصراً توسط تیم اصلی Blockly انجام می‌شود تا مطمئن شویم که مسائل در جای اشتباه قرار نمی‌گیرند.

اندازه

بعضی از مسائل خیلی کوتاه و زیبا هستند، در حالی که حل کردن بعضی دیگر ممکن است هفته‌ها طول بکشد. این برچسب‌ها به شما کمک می‌کنند تا بفهمید یک مسئله احتمالاً چقدر کار می‌برد.

  • اولین مشکل خوب : این مشکلات برای افرادی که تازه با مخزن آشنا شده‌اند عالی است. آنها باید کمتر از نصف روز کار کنند و نیاز به آشنایی محدودی با کد بیس دارند. می‌توانید بلافاصله و بدون نیاز به تایید تیم، روی این مشکلات کار کنید.

صلاحیت قضایی

کار بر روی یک مخزن (repo) که به طور گسترده استفاده می‌شود می‌تواند یک فرآیند حساس باشد و برخی از مسائل می‌توانند حساس‌تر از بقیه باشند. این برچسب‌ها به شما کمک می‌کنند تا تشخیص دهید کدام مسائل برای مشارکت باز هستند و از کدام مسائل باید اجتناب کنید.

  • درخواست کمک : این مسائل مختص مشارکت‌کنندگان است. اغلب این‌ها ویژگی‌هایی هستند که تیم اصلی فکر می‌کند مفید خواهند بود، اما وقت پیاده‌سازی آن‌ها را ندارد. ممکن است به بحث یا پیاده‌سازی نیاز داشته باشند، بنابراین برچسب وضعیت را بررسی کنید تا ببینید چه کاری لازم است. این مکان خوبی برای یافتن پروژه‌های خلاقانه و سرگرم‌کننده است!
  • داخلی : این مسائل مختص اعضای تیم اصلی است. اغلب آنها اشکالات حساس یا پیچیده‌ای هستند که نیاز به بحث ویژه دارند. بهتر است از این موارد دوری کنید زیرا وضعیت پیرامون آنها می‌تواند به سرعت تغییر کند!
  • هیچکدام : مسائلی که هیچ‌کدام برچسب ندارند، می‌توانند توسط مشارکت‌کنندگان و اعضای تیم اصلی اصلاح شوند. اگر مسئله‌ای بدون برچسب دیدید که برایتان جالب به نظر می‌رسد، آن را بپذیرید و بررسی کنید!

وضعیت

برخی از مسائل (به‌ویژه درخواست‌های ویژگی) قبل از اینکه بتوان آنها را "بسته‌شده" در نظر گرفت، مراحل مختلفی را طی می‌کنند. این برچسب‌ها به شما می‌گویند که یک مسئله در حال حاضر در چه مرحله‌ای است، بنابراین می‌توانید بدانید که در مرحله بعد چه کاری باید انجام شود.

  • بحث : این مسائل در مرحله بحث هستند، به این معنی که هنوز سوالاتی وجود دارد که باید قبل از اجرا به آنها پاسخ داده شود. اگر در رابطه با این موضوع نظری دارید، لطفاً نظر خود را بنویسید! ما همیشه منتظر نظرات بیشتر هستیم.
  • پیاده‌سازی : این مسائل به اندازه کافی مورد بحث قرار گرفته‌اند که به وضوح تعریف شده‌اند و به مرحله پیاده‌سازی رسیده‌اند. آن‌ها یا منتظر پیاده‌سازی هستند یا در حال پیاده‌سازی هستند. اگر علاقه‌مند به کار روی یکی از این موارد هستید، کل موضوع را بخوانید و سپس در قسمت نظرات بنویسید که می‌خواهید روی کدام بخش کار کنید، سپس شروع کنید!
  • هیچکدام : مسائلی که هیچ‌کدام برچسب ندارند، می‌توانند در هیچ‌کدام از این دو حالت باشند. اگر در مورد نحوه‌ی پیاده‌سازی مسئله نظری دارید، لطفاً نظر خود را بنویسید! یا اگر علاقه‌مند به کار روی مسئله هستید، بهتر است نظر خود را بنویسید و بپرسید که آیا آماده‌ی پیاده‌سازی است یا خیر.

نوع

مسائل مختلف نیاز به پاسخ‌های متفاوتی دارند. برخی فقط به ویرایش چند خط کد نیاز دارند، در حالی که برخی دیگر به طراحی و بحث زیادی نیاز دارند. این برچسب‌ها به شما می‌گویند که یک مسئله به چه نوع اقدامی نیاز دارد.

  • اشکال : این مشکلات، مشکلی را در کدبیس مستند می‌کنند. اغلب برای تشخیص علت مشکل، نیاز به اشکال‌زدایی دارند، اما برخی از آنها را می‌توان در یک چشم به هم زدن برطرف کرد. اگر دوست دارید عمیقاً بررسی کنید تا بفهمید کد چگونه کار می‌کند، این مشکلات برای شما عالی خواهند بود. می‌توانید با رفع اشکال یا با بررسی دقیق مشکل و نوشتن توضیحی روشن در مورد علت اصلی، به ما کمک کنید.
  • درخواست ویژگی : این مسائل، ویژگی‌ای را مستند می‌کنند که شخصی مایل به اضافه شدن آن است. این می‌تواند برای کل مخزن یا برای یک پروژه خاص اعمال شود. اگر دوست دارید ایده‌های طراحی را تکمیل کنید و قابلیت‌های جدیدی اضافه کنید، این مسائل می‌توانند برای شما عالی باشند.
  • سوال : این مشکلات، سوالی را که کسی در مورد کدبیس دارد، مستند می‌کنند. معمولاً این سوالات به انجمن توسعه‌دهندگان هدایت می‌شوند، اما اگر سوالی دیدید که احساس می‌کنید می‌توانید به آن کمک کنید، می‌توانید به آن پاسخ دهید.

دسته بندی

این مخزن شامل چندین نوع پروژه مختلف با مخاطبان هدف متفاوت است. اگر به آموزش‌ها علاقه دارید یا عاشق کار روی افزونه‌ها هستید، این برچسب‌ها می‌توانند به شما در یافتن موضوعات مورد علاقه‌تان کمک کنند.

  • Codelab : این مشکلات مربوط به Blockly codelabs ، مجموعه‌ای از آموزش‌های تعاملی، است.
  • مثال : این مسائل مربوط به مثال‌های Blockly است، مجموعه‌ای از دموهای مستقل که نحوه‌ی گنجاندن و گسترش Blockly را نشان می‌دهند.
  • افزونه : این مشکلات مربوط به افزونه‌های Blockly است، مجموعه‌ای از افزونه‌ها که قابلیت‌های Blockly را اضافه می‌کنند.

پروژه

و اگر می‌خواهید جزئیات بیشتری را بررسی کنید، برچسب‌هایی برای پروژه‌های جداگانه نیز وجود دارد. این برچسب‌ها معمولاً برای افزونه‌ها ایجاد می‌شوند که معمولاً مشکلات بیشتری در رابطه با آنها وجود دارد، اما می‌توانند برای آزمایشگاه‌های کد و مثال‌ها نیز ایجاد شوند. اگر پروژه خاصی دارید که به آن علاقه‌مند هستید، این برچسب‌ها می‌توانند به شما در یافتن مشکلات مربوط به آن پروژه کمک کنند.

برای دیدن اینکه آیا برچسبی برای پروژه مورد نظر شما وجود دارد، لیست کامل برچسب‌ها را مشاهده کنید:

دیگر

مانند هر مجموعه دیگری از چیزها، چند مورد عجیب و غریب نیز وجود دارد که باید در مورد آنها بدانید. این برچسب‌ها ممکن است وقتی به دنبال موضوعی برای کار هستید، چندان مفید نباشند، اما همچنان می‌توانند آموزنده باشند.

  • اولویت‌بندی : این مشکلات هنوز توسط تیم اصلی به درستی برچسب‌گذاری نشده‌اند. مشکلاتی که این برچسب را دارند، ممکن است از قبل شامل برچسب ساده دیگری مانند اشکال یا درخواست ویژگی باشند، اما احتمالاً به زودی برچسب‌های بیشتری اضافه خواهد شد.
  • تکراری : این مسائل، مشکل، درخواست یا سوالی را مستند می‌کنند که قبلاً توسط یک مسئله دیگر پوشش داده شده است. این برچسب به شما می‌گوید که نباید به این مسئله پاسخ دهید، بلکه باید به مسئله اصلی پاسخ دهید.