خواندن گزارش حسابرسی VPN: دامنه بر نشان می‌چربد
نشان حسابرسی چهار واقعیت را پنهان می‌کند که ارزش خواندن دارند: کدام اجزا آزمایش شدند، کدام نسخه، چه چیزی کنار گذاشته شد و کدام اصلاحات دوباره آزمایش شدند.
نشان‌ها ارزان نمایش داده می‌شوند و گران تفسیر می‌شوند. گزارش حسابرسی منتشرشده تکه‌ای محدود از کار مهندسی است: ارزیاب نام‌داری اجزای نام‌داری را در نسخه‌ای نام‌دار، با روشی اعلام‌شده و بودجه زمانی بررسی کرده است. این چهار واقعیت تعیین می‌کنند نتیجه چه چیزی را می‌تواند پشتیبانی کند، و معمولاً در چند صفحه نخست هستند نه در خلاصه بازاریابی. خواندنشان ده دقیقه وقت می‌گیرد و از خطای رایج گسترش یافته یک برنامه کلاینت به کل سرویس جلوگیری می‌کند.
بخش دامنه در واقع چه چیزی را محدود می‌کند
بیانیه دامنه حصاری است و هر چیز بیرون آن بی‌پاسخ می‌ماند نه گذرانده. گزارش‌ها اجزای بررسی‌شده، بازه کامیت یا شناسه ساخت، محیط استفاده‌شده و مدل تعامل مجاز را فهرست می‌کنند. کلاینت رومیزی، برنامه موبایل، کد سرور، بک‌اند حساب و زیرساخت تولید پنج موضوع متفاوت‌اند و یک قرارداد می‌تواند هر زیرمجموعه‌ای از آنها را پوشش دهد.
استثناها به اندازه شمول‌ها مهم‌اند، چون عمداً ذکر می‌شوند و با بی‌دقتی خوانده می‌شوند. سامانه حسابی که خارج از دامنه توصیف شود به‌طور تلویحی ایمن نیست، و برنامه موبایلی که از قرارداد بیرون بماند صرفاً بررسی نشده است. هر جزء آزمایش‌نشده را در یادداشت‌های خود ناشناخته علامت بزنید و در برابر وسوسه پر کردن شکاف با اعتبار مقاومت کنید.
دو نوع آزمون به پرسش‌های متفاوت پاسخ می‌دهند
بازبینی کد منبع و آزمون زمان اجرا به دنبال خرابی‌های متفاوتی می‌گردند. بازبین با خواندن کد می‌تواند مشتق‌سازی کلید را دنبال کند، نبود بررسی طول را ببیند و درباره یک تجزیه‌گر کامل بدون اجرای آن استدلال کند. آزمون‌گر روی سرویس در حال اجرا کشف می‌کند ساخت مستقرشده واقعاً چه می‌کند: گواهی‌ای که برنامه رد می‌کند، پروتکل جایگزینی که هنوز فعال است، نقطه پایانی‌ای که از طریق پیکربندی‌ای که هیچ‌کس بازبینی نکرده، بنر نسخه را نشت می‌دهد.
هیچ‌کدام جای دیگری را نمی‌گیرد و گزارش معمولاً می‌گوید کدام انجام شده است. وقتی خلاصه‌ای بدون این تفکیک می‌گوید «حسابرسی شده»، ابهام در خلاصه است نه در گزارش.
محدودیت‌های دسترسی همین کار را می‌کنند. قرارداد جعبه سیاه نمی‌تواند پیکربندی سرور را ببیند، و بازبینی معماری که هرگز نقطه پایانی مستقر را لمس نمی‌کند نمی‌تواند متوجه شود تولید با نمودار تفاوت دارد. هر دو مشروع‌اند؛ درهم آمیختن نتایجشان نه.
چگونه یک یافته به نسخه اصلاح‌شده تبدیل می‌شود
نیمه ارزشمند گزارش جدول رفع نقص است: هر یافته، شدت آن بر پایه روش ارزیاب، پاسخ اپراتور و نتیجه آزمون دوباره. اعداد شدت از روش‌شناسی انتخابی می‌آیند نه از طبیعت، پس شدت‌ها را درون یک گزارش مقایسه کنید نه میان دو گزارش با مقیاس‌های متفاوت.
سپس اصلاح را به نرم‌افزار منتشرشده پیوند دهید. یافته اصلاح‌شده تنها وقتی برای کاربر اهمیت دارد که نسخه حامل اصلاح همان نسخه نصب‌شده باشد، و به همین دلیل شناسه ساخت گزارش و تغییرنگار انتشار باید با هم خوانده شوند. آزمون دوباره‌ای که اصلاح را پوشش داده حلقه را می‌بندد؛ اصلاح آزمون‌نشده یک ادعاست. همچنین اصلاحی که فقط در شاخه‌ای منتشر شده که هیچ انتشار پایداری آن را ادغام نکرده است.
چیزی که نشان نمی‌تواند به شما بگوید
نبود یافته اثبات نبود نقص نیست. قرارداد کوتاه با بودجه ثابت چیزهایی را از دست می‌دهد، و خوانش صادقانه یک گزارش پاک این است که ارزیاب در زمان موجود کلاس‌های مشکلی را که می‌جست نیافته است.
نشان همچنین نمی‌تواند از ویژگی‌های بیرون دامنه‌اش سخن بگوید. ادعاها درباره رویه ثبت رویداد، صلاحیت قضایی یا نگهداری در سندی سیاستی زندگی می‌کنند، نه در حسابرسی یک برنامه کلاینت، و هیچ اعتباری از ارزیاب از آن مرز عبور نمی‌کند.
ثبت شواهدی که می‌توانید از آن دفاع کنید
استناد را در سه بخش بنویسید: جزء، نسخه و اصلاح تأییدشده. قراردادی منتشرشده مانند حسابرسی VPN که Mozilla سفارش داد دقیقاً همان گزاره‌هایی را پشتیبانی می‌کند که دامنه‌اش توصیف می‌کند و نه چیزی گسترده‌تر، که وقتی استناد دقیق باشد هنوز ارزش زیادی دارد. همان گزارشی که برای چیزی استناد شود که هرگز بررسی نکرده، از نبود استناد کم‌ارزش‌تر است، چون به اعتمادی دعوت می‌کند که هیچ‌کس به دست نیاورده است.
وقتی ویژگی ادعاشده بیرون همه گزارش‌های موجود می‌افتد، آن را در سند حل‌نشده بگذارید. سطر حل‌نشده به پرسش پیگیری دعوت می‌کند؛ نشان نه. تنها استثنا ویژگی‌ای است که سند دیگری، به همان اندازه مشخص، آن را حل می‌کند، و آنگاه استناد تغییر می‌کند نه ادعا.
دو عادت دیگر خواندن را پایدار می‌کند: تاریخ گزارش را در برابر انتشاری که واقعاً اجرا می‌کنید یادداشت کنید، و تفاوت میان آنچه آزموده شد و آنچه مستقر کردید را نگه دارید. هر دو تصمیم اعتماد را به چیزی تبدیل می‌کنند که همکاری می‌تواند بررسی کند.