بسته‌های ثابت: قیمت نوشته‌شده، تحویل تاریخ‌دار
← یادداشت‌هایی دربارهٔ ساخت نرم‌افزار

یادداشت · تحویل گزارش

گزارش تحویل بازرسی باید چه چیزی داشته باشد

«خروجی» یک فایل است. «تحویل» یک انتقال با گیرنده، زمان و نسخه است. گزارش‌ها وقتی خراب می‌شوند که این دو یکی گرفته شوند.

آخرین به‌روزرسانی: ۲۸ مهر ۱۴۰۵

چرا خروجی کافی نیست

PDFی که از صفحهٔ فعلی ساخته می‌شود، هیچ چیزی دربارهٔ زمان ساخت یا تغییرات بعدی‌اش نمی‌گوید. اگر یک هفته بعد PDF دوم ظاهر شود، گیرنده نمی‌تواند بفهمد کدام معتبر است.

حداقل محتوای یک گزارش تحویل

عنصرچرا هست
شناسه و محل داراییتا خواننده بداند چه چیزی بازرسی شده
شمارهٔ نسخهٔ هر رکوردتا ویرایش بعدی دیده شود
رویدادهای بازبینی (چه کسی، چه وقت)تا معلوم شود انسان چه چیزی را تأیید کرده
بررسی‌های انجام‌شده و نتیجه‌شانتا «انجام نشده» از «رد شده» قابل تفکیک باشد
موارد باز یا بررسی‌نشدههمان بخشی که بیشتر گزارش‌ها بی‌صدا حذف می‌کنند
زمان تولید و گیرندهتا دو نسخه قابل مرتب‌شدن باشند

بررسی‌نشده باید دیده شود

گزارشی که فقط موفقیت‌ها را فهرست می‌کند، قانع‌کننده‌تر نیست؛ فقط کم‌فایده‌تر است. خط «بررسی شد، موردی نبود» و خط «بررسی نشد» هرگز نباید یک‌شکل باشند.

یک تحویل، یک گزارش

ساخت گزارش شخصی‌سازی‌شده برای هر خواننده سخاوتمندانه به نظر می‌رسد و مقایسه‌پذیری را نابود می‌کند. برای هر تحویل یک گزارش بسازید و همان را به اشتراک بگذارید.

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

ترجیح می‌دهید مستقیم پیام بدهید؟

کوتاه بنویسید به چه چیزی نیاز دارید؛ قدم بعدی را با هم روشن می‌کنیم.