قالب‌های مسئله

قالب مسئله

نمای کلی

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

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

ابتدا قالب‌ها را بخوانید تا قواعد مشترک هر سه هدف — دسترسی، پیش‌فرض‌ها، نسخه‌ها و رفتار در برابر ارجاع‌های ازدست‌رفته — روشن باشد.

ساخت قالب مسئلهٔ استاندارد

کجا. Settings → Issues → Templates برای کل فضای کاری، یا Settings → Your teams → <تیم> → Templates برای یک تیم. مدیران تیم قالب تیمی می‌سازند؛ قالب فضای کاری نیاز به مدیر فضای کاری دارد.

یک قالب استاندارد چه چیزی را تعیین می‌کند

دو غیبت عمدی‌اند. تاریخ سررسید در قالب استاندارد تعیین نمی‌شود: آفست نسبی وجود ندارد و تاریخ مطلقی که در قالب ثبت شود فردای ذخیره‌شدن منسوخ است. سررسید را به‌صورت یک پرسش فرم بخواهید. زیرمسئله‌ها بخشی از ساخت استاندارد مسئله نیستند — کارِ ازپیش‌ساخته در قالب پروژه قرار دارد.

ساخت قالب فرم

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

انواع پرسش

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

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

متن پاسخ هرگز به‌عنوان Markdown تفسیر نمی‌شود. اگر کسی # فوری بنویسد، همان کلمه‌ها ثبت می‌شود نه یک عنوان در سند شما.

پرسش‌های ویژگی

پرسش ویژگی، پاسخ را مستقیم به خود مسئله متصل می‌کند، نه به توضیحات آن. قالب مسئله می‌تواند این‌ها را بپرسد:

عنوان، توضیح، نوع، اولویت، تاریخ سررسید، برچسب‌ها، تیم، مسئول، پروژه، نقطهٔ عطف و تخمین.

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

شناسه‌ها

هر پرسش شناسه‌ای دارد و پاسخ‌ها در برابر آن ثبت می‌شوند. تغییر عنوان یک پرسش پاسخ‌های ثبت‌شده را دست‌نخورده می‌گذارد؛ تغییر شناسه نه — به همین دلیل شناسه پس از ذخیرهٔ قالب ثابت می‌ماند. همین برای گزینه‌های کشویی و چندگزینه‌ای هم صدق می‌کند: مقدار ذخیره‌شده چیزی است که پاسخ‌ها ثبت می‌کنند و برچسب چیزی است که افراد می‌خوانند.

استفاده از قالب مسئله

قالب را از کنترل قالب در فرم ساخت مسئله، کنار تیم، انتخاب کنید. فهرست، آنچه را برای تیم مقصد قابل استفاده است نشان می‌دهد؛ گروه‌بندی‌شده بر اساس دسترسی، با قالب‌های فضای کاری در ابتدا.

دو مسیر دیگر به همان‌جا می‌رسند. ⌘K و سپس New issue from template… فرم ساخت را با انتخابگر بازشده باز می‌کند. پیوند مستقیمِ کپی‌شده از ردیف قالب هم آن را با همان قالب ازپیش‌انتخاب‌شده باز می‌کند.

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

چیزهایی که قالب تحمیل نمی‌کند

چند مقدار عمداً دست‌نخورده می‌مانند، حتی اگر قالب آن‌ها را تعیین کرده باشد:

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

قالب پیش‌فرض مسئله

هر تیم می‌تواند تعیین کند فرم ساخت مسئله‌اش با کدام قالب باز شود، و این تنظیم برای دو مخاطب جداگانه انجام می‌شود:

• اعضای تیم مقصد، که فرم ساخت کامل را می‌گیرند.
• غیراعضا، که معمولاً برای تیمی ثبت می‌کنند که در آن کار نمی‌کنند.

قالب فرم فقط می‌تواند پیش‌فرض غیراعضا باشد. جایگزین‌کردن فرم روزمرهٔ یک عضو با پرسش‌نامه یک پیکربندی اشتباه است و Pulse به‌جای اعمال آن، آن را رد می‌کند. اگر با این حال قالب فرمی به مخاطب عضو متصل شود، فرم ساخت خالی باز می‌شود.

حذف قالبی که پیش‌فرض کسی است، آن اتصال را پاک می‌کند. از آن پس فرم ساخت خالی باز می‌شود؛ این نتیجهٔ عادی حذف است، نه خطا.

مدیریت قالب‌ها

منوی … روی ردیف قالب را باز کنید.

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

پیش از تأیید حذف، Pulse می‌گوید چند مسئله از این قالب ساخته شده‌اند و آن مسئله‌ها همچنان قالب و نسخهٔ منشأ خود را نشان می‌دهند.

دسترسی قالب با ویرایش آن و کنترل دسترسی تغییر می‌کند. این جابه‌جایی نسخهٔ جدید نمی‌سازد، اما به اختیار روی هر دو دامنهٔ قبلی و جدید نیاز دارد.

تبدیل بین استاندارد و فرم

نوع یک قالب ذخیره‌شده را می‌توانید با کنترل نوع در ویرایشگر تغییر دهید.

تبدیل استاندارد به فرم بدون از دست رفتن چیزی انجام می‌شود: ویژگی‌ها می‌مانند و شما پرسش اضافه می‌کنید.

تبدیل فرم به استاندارد این‌طور نیست. قالب استاندارد نمی‌تواند چیزی بپرسد، پس پرسش‌های متن، متن بلند، فهرست کشویی، چندگزینه‌ای، تاریخ و بارگذاری حذف می‌شوند. Pulse دقیقاً نام پرسش‌هایی را که از دست می‌روند می‌گوید و پیش از ذخیره تأیید می‌خواهد. پرسش‌های ویژگی و دستورالعمل‌ها باقی می‌مانند، چون قالب استاندارد هر دو را می‌تواند بیان کند.

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

محدودیت‌ها و خطاها

دو خطا ارزش شناختن دارند:

• کس دیگری زودتر ذخیره کرد. قالب هنگام ویرایش شما تغییر کرده است. آن را دوباره بارگذاری کنید، نسخهٔ او را ببینید و تغییرات خود را دوباره اعمال کنید. Pulse به‌جای بازنویسی کار دیگران، ذخیره را رد می‌کند.
• این قالب اینجا قابل استفاده نیست. برای تیمی که در آن ثبت می‌کنید در دسترس نیست؛ معمولاً چون به تیم دیگری محدود شده است.

پرسش‌های پرتکرار

قدم بعدی

• تخمین‌ها
• قالب‌های پروژه
• قالب‌های درخواست
• نمای کلی قالب‌ها