رفتن به محتوا

آزمون پذیرش مستندات

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

یک پروژهٔ خالی با نسخهٔ پشتیبانی‌شدهٔ Angular، React یا Vue بسازید. زمان شروع، نسخه‌ها، مرورگر، ورودی‌های استفاده‌شده و هر نقطهٔ ابهام را ثبت کنید. در میانهٔ کار از سورس مخزن کمک نگیرید.

یک Button را با package یا CLI نصب کنید، CSS درست را وارد کنید و نام قابل‌دسترسی و فعال‌سازی با صفحه‌کلید را بررسی کنید.

حداقل یک token رنگ و focus را برای حالت روشن و تیره تغییر دهید. contrast، RTL، zoom و reduced motion را کنترل کنید.

یک کنترل دارای name، validation و پیام خطا بسازید. مقدار FormData، announcement خطا و جلوگیری از submit تکراری را ثبت کنید.

Dialog یا Popover را باز کنید. focus اولیه، containment، Escape، outside press، scroll و بازگشت focus باید قابل‌پیش‌بینی باشند.

یک callback، emit یا output مستندشده را متصل کنید و مطمئن شوید هر فعالیت pointer یا صفحه‌کلید فقط یک event تولید می‌کند.

۶. به‌روزرسانی کامپوننت کپی‌شده

Section titled “۶. به‌روزرسانی کامپوننت کپی‌شده”

با diff تغییر محلی را با registry مقایسه کنید. سپس یک ارتقای سه‌طرفه انجام دهید و نشان دهید سفارشی‌سازی محلی حفظ شده است.

همان کار را در adapter دوم پیدا کنید. نام API ممکن است بومی فریم‌ورک باشد، اما نتیجهٔ رفتاری، فرم و دسترس‌پذیری باید معادل بماند.

بررسی درک خوانندهٔ تازه‌وارد

Section titled “بررسی درک خوانندهٔ تازه‌وارد”

خواننده باید بتواند تفاوت package و copied source، محل CSS، قرارداد state، API رویداد و مسیر گزارش feedback را بدون راهنمای شفاهی توضیح دهد.

کارشواهد CIشواهد دستی لازم
نصبbuild نمونه‌های سه فریم‌ورکactivation و accessible name
themetokenها و ۲۰ جفت contrastfocus بصری، RTL، zoom و reduced motion
فرمcontractها و مثال‌های کامپایل‌شدهمقدار submit، announcement و focus
overlaycontract و browser testcontainment، restoration، scroll و viewport باریک
eventAPI table و مثال‌هایک event برای هر activation
copied sourceآزمون init، add، diff و overwriteکیفیت review سه‌طرفه
تغییر فریم‌ورکparity و مثال هر adapterدرک خواننده و نتیجهٔ معادل

نتیجهٔ CI به‌تنهایی جای مشاهدهٔ دستی را نمی‌گیرد. برای release candidate، خروجی آزمون، تاریخ، نسخه‌ها، رضایت شرکت‌کننده و مشکل‌های کشف‌شده را ثبت کنید.

Last verified on 2026-08-13 against Simurgh registry 0.1.1.