اولویتبندی هشدارهای Vale با ایجنت
اگر اولین گزارش Vale هزاران پیام دارد، ببینید کدام چند قانون بیشترشان را ساختهاند. برای هر قانون تصمیم بگیرید متن باید تغییر کند یا خود قاعده.
اولویتبندی هشدارهای Vale با ایجنت وقتی ارزش دارد که یک تیم برای اولین بار نوشتههای قدیمیاش را بررسی میکند. تصور کنید چند سال است راهنمای محصول نوشتهاید و حالا ابزار برای هزاران جمله پیام دارد. تعداد زیاد پیامها بهتنهایی نمیگوید متنها چقدر کار دارند. اسکیل triage به ایجنتتون کمک میکند ببیند کدام قانون بارها تکرار شده و چند مورد واقعا جلو عبور از بررسی را میگیرند.
مثلا ممکن است بیشتر پیامها مربوط به شکل نوشتن عنوانها باشند. اگر تیم شکل فعلی را میپسندد، این یک اختلاف شیوهنامه است. اما اگر قانون درست است و فقط متنهای قدیمی با آن جور نیستند، میتونید آن را فعلا در حد پیشنهاد نگه دارید تا نویسندههای مطالب تازه هم راهنما داشته باشند. تصمیم هر قانون کنار تعداد مواردش میآید و راحتتر میتوانید درباره هزینه تغییر با سردبیر حرف بزنید.
کاربردها
- برای شمارش هشدارها، پیامهای مربوط به یک قانون را از فایلهای گوناگون کنار هم جمع کنید.
- با پیدا کردن قانون پرتکرار، بفهمید علت شلوغی گزارش یک ترجیح نگارشی است یا اشتباهی که باید اصلاح شود.
- در تعیین شدت خطا، جدا ببینید کدام پیام میتونه روند انتشار را متوقف کند و کدام فقط پیشنهاد است.
- با مرور شیوهنامه تیم، درباره اصلاح متن، کاهش سطح یا کنار گذاشتن یک قانون مشخص تصمیم بگیرید.
- برای کار بعدی معلوم کنید تغییر یک عنوان ساده چقدر وقت میگیرد و کدام اصلاح به بازخوانی نویسنده نیاز دارد.
نصب و استفاده
- اسکیل را نصب کنید و پوشه متنها را در پروژهای باز کنید که Vale و قواعدش از قبل کار میکنند. ابزار jq هم برای دستهبندی گزارش لازم است.
- بگید «راهنماهای قدیمی را بررسی کن. ده قانون پرتکرار، شدت هر کدام و دلیل پیشنهادت برای برخورد با آن را بنویس».
- نتیجه را با ویراستار بخونید. درباره قواعدی که سلیقه تیم را عوض میکنند تصمیم بگیرید و بعد سراغ ویرایش فایلها برید.
سوالات متداول
منبع
ساخته Joseph Kato (Vale). نام اصلی: triage، منتشرشده در GitHub با مجوز MIT.
مشاهده در GitHub