مسائل (Issues)

مسائل ابزاری قدرتمند برای ردیابی باگ‌ها، درخواست‌های ویژگی و وظایف در پروژه شما هستند.

ایجاد مسئله جدید

مراحل

1. به تب مسائل در مخزن خود بروید
2. روی "مسئله جدید" کلیک کنید
3. پر کنید:
   • عنوان: عنوان واضح و توصیفی
   • توضیحات: چه مشکلی وجود دارد یا چه چیزی نیاز است
   • برچسب‌ها: دسته‌بندی مسئله
   • تخصیص‌دهنده: چه کسی باید روی آن کار کند
   • نقطه عطف: بخشی از کدام مایلستون است
4. روی "ایجاد مسئله" کلیک کنید

ویژگی‌های مسائل

برچسب‌ها (Labels)

برچسب‌ها به دسته‌بندی مسائل کمک می‌کنند:

• bug - یک خطا
• enhancement - ویژگی جدید
• documentation - به‌روزرسانی مستندات
• question - سوال یا ابهام
• wontfix - تعمیر نمی‌شود
• duplicate - تکراری
• help wanted - نیاز به کمک

نقاط عطف (Milestones)

مایلستون‌ها مسائل را گروه‌بندی می‌کنند:

• نسخه ۱.۰
• Sprint فعلی
• انتشار بتا
• رفع باگ‌های بحرانی

تخصیص‌دهندگان (Assignees)

مشخص کنید چه کسی مسئول است:

• یک یا چند نفر اضافه کنید
• هر شخص می‌تواند چندین مسئله داشته باشد
• وضعیت را به‌روز نگه دارید

مدیریت مسائل

وضعیت مسئله

باز:

• مسئله فعال است
• هنوز حل نشده
• روی آن کار می‌شود

بسته:

• مسئله حل شده
• ویژگی پیاده‌سازی شد
• باگ رفع شد

کامنت‌گذاری

با اعضای تیم ارتباط برقرار کنید:

1. در پایین مسئله کامنت بنویسید
2. از @username برای منشن کردن استفاده کنید
3. کد نمونه اضافه کنید
4. اسکرین‌شات پیوست کنید

Markdown در مسائل

از Markdown کامل پشتیبانی می‌شود:

## عنوان

**متن bold** و *متن italic*

- لیست مورد ۱
- لیست مورد ۲

python print("Hello World")

[لینک](https://example.com)

![تصویر](image-url)

بهترین شیوه‌ها

برای نویسندگان

• ✅ عنوان واضح و مختصر بنویسید
• ✅ توضیحات دقیق ارائه دهید
• ✅ مراحل بازتولید شامل کنید (برای باگ‌ها)
• ✅ اسکرین‌شات اضافه کنید
• ✅ برچسب‌های مناسب استفاده کنید
• ✅ انتظار چه رفتاری را داشتید توضیح دهید

برای مدیران

• ✅ مسائل را سریع بررسی کنید
• ✅ برچسب‌های مناسب اضافه کنید
• ✅ به افراد مناسب تخصیص دهید
• ✅ به مسائل اولویت دهید
• ✅ وضعیت را به‌روز نگه دارید
• ✅ مسائل قدیمی را ببندید

الگوهای مسئله

گزارش باگ

## توضیح
توضیح مختصری از باگ

## مراحل بازتولید
1. مرحله اول
2. مرحله دوم
3. مشاهده خطا

## رفتار مورد انتظار
چه چیزی باید اتفاق می‌افتاد

## اسکرین‌شات‌ها
اگر قابل اجراست، اسکرین‌شات اضافه کنید

## محیط
- سیستم‌عامل: Windows/Linux/macOS
- مرورگر: Chrome/Firefox/Safari
- نسخه: 1.0.0

درخواست ویژگی

## مشکل مرتبط
آیا این درخواست ویژگی به مشکل مربوط است؟

## راه‌حل پیشنهادی
چه اتفاقی باید بیفتد

## جایگزین‌ها
راه‌حل‌های دیگری که در نظر گرفتید

## اطلاعات اضافی
هر چیز دیگری که مفید است

جستجوی مسائل

فیلترها

• is:open - مسائل باز
• is:closed - مسائل بسته
• is:issue - فقط مسائل
• label:bug - برچسب خاص
• author:username - نویسنده خاص
• assignee:username - تخصیص‌دهنده خاص

مثال‌ها

is:open label:bug
is:closed milestone:"نسخه ۱.۰"
author:john assignee:jane

بستن مسائل

روش‌ها

دستی:

1. روی "بستن مسئله" کلیک کنید
2. کامنت اختیاری اضافه کنید
3. تأیید کنید

خودکار با Commit:

git commit -m "رفع باگ #123"
git commit -m "close #456"
git commit -m "fixes #789"

کلمات کلیدی: close, closes, closed, fix, fixes, fixed, resolve, resolves, resolved

مراحل بعدی

• درباره درخواست‌های تغییر بیاموزید
• بررسی کد را کاوش کنید
• مبانی گیت را بخوانید