بیانیه‌های دسترس‌پذیری حالا جای مشخصی در GitHub دارند

GitHub اکنون فایل‌های ACCESSIBILITY.md را برجسته می‌کند و به نگه‌دارندگان کمک می‌کند اهداف دسترس‌پذیری، موانع شناخته‌شده، محیط‌های پشتیبانی‌شده، انتظارات از مشارکت‌کنندگان و فرایندهای گزارش‌دهی را مستند کنند.

کار دسترس‌پذیری اغلب در سیستم‌های پیگیری مسئله (issue tracker)، راهنماهای مشارکت، گزارش‌های ارزیابی، دانش تیمی و گفت‌وگو با کاربران جریان دارد. وقتی این اطلاعات جای مشخص و قابل پیش‌بینی نداشته باشد، افرادی که با مانعی روبه‌رو می‌شوند باید آن را جست‌وجو کنند و نگه‌دارندگان نیز با تغییر مشارکت‌کنندگان و مالکیت پروژه، زمینه و بافت اطلاعات را از دست می‌دهند.

فایل ACCESSIBILITY.md که اکنون در صفحه نمای کلی مخزن نمایش داده می‌شود، به پروژه یک جای پایدار می‌دهد تا اهداف دسترس‌پذیری، انتظارات از مشارکت‌کنندگان، محیط‌های پشتیبانی‌شده، محدودیت‌های شناخته‌شده و فرایند گزارش موانع را توضیح دهد.

GitHub یافتن بیانیه‌های دسترس‌پذیری را آسان‌تر می‌کند

GitHub اکنون فایل ACCESSIBILITY.md را در ریشه مخزن، پوشه .github/ یا پوشه docs/ شناسایی می‌کند. یک مخزن می‌تواند بیانیه را از مخزن .github/ سازمان خود نیز به ارث ببرد. برای مخازن عمومی، نگه‌دارندگان می‌توانند از مسیر Insights > Community Standards و با استفاده از یک سند آغازین کوتاه، بیانیه‌ای اضافه یا پیشنهاد کنند.

فایل‌های سلامت جامعه (community health files) در GitHub به افراد کمک می‌کنند نحوه کار یک پروژه را درک کنند:

راهنماهای مشارکت توضیح می‌دهند چگونه تغییر پیشنهاد شود

آیین‌نامه‌های رفتاری انتظارات برای مشارکت را مشخص می‌کنند

سیاست‌های امنیتی توضیح می‌دهند چگونه آسیب‌پذیری‌ها گزارش شوند

به رسمیت شناختن ACCESSIBILITY.md به اطلاعات دسترس‌پذیری جایگاهی اختصاصی در کنار همین راهنماها می‌دهد.

مخازن جدید همچنین به‌طور پیش‌فرض یک برچسب مسئله (issue label) دسترس‌پذیری دارند. بیانیه توضیح می‌دهد چگونه مانعی گزارش شود و پس از آن چه انتظاری می‌رود، در حالی که برچسب به نگه‌دارندگان کمک می‌کند کارهای حاصل را سازمان‌دهی و پیگیری کنند.

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

برای نمونه، بیانیه دسترس‌پذیری GitHub CLI تنظیمات، موانع شناخته‌شده و راه‌حل‌های موقت را مستند می‌کند. این بیانیه توضیح می‌دهد چرا دنبال کردن خروجی جدولی با صفحه‌خوان می‌تواند دشوار باشد و دستوری ارائه می‌دهد که شماره و عنوان pull requestها را هر کدام در یک خط چاپ می‌کند. همچنین از مشارکت‌کنندگانی که اعلان‌ها (prompt) یا خروجی را تغییر می‌دهند می‌خواهد نتایج را با تنظیمات مرتبط دسترس‌پذیری فعال نشان دهند. توسعه‌دهندگانی که از CLI استفاده می‌کنند یک راه‌حل موقت مشخص به دست می‌آورند؛ توسعه‌دهندگانی که در آن مشارکت می‌کنند انتظارات روشنی برای تغییرات خود دارند.

بیانیه دسترس‌پذیری GitHub Annotation Toolkit محدودیتی در کتابخانه Figma آن را مستند می‌کند: حاشیه‌نویسی‌ها (annotation) با استفاده از موقعیت روی بوم (canvas)، خطوط اتصال و شماره‌های منطبق، روابط را به‌صورت بصری منتقل می‌کنند. دسترسی به اشیای جداگانه بوم لزوماً مشخص نمی‌کند این روابط چه هستند.

این بیانیه به همکاران یک جایگزین مشخص می‌دهد: ارائه توضیح متنی ساختاریافته‌ای که هر عنصر حاشیه‌نویسی‌شده، معنای موردنظر و رفتار آن و هر ترتیب مرتبط را مشخص کند. برای توسعه‌دهندگانی که تحویل طراحی را آماده می‌کنند یا دریافت می‌کنند، این توضیح روشن می‌کند چه اطلاعاتی باید همراه حاشیه‌نویسی‌های بصری باشد.

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

آنچه پروژه می‌تواند نگه دارد را مستند کنید

قالب ثابت و یکسانی برای فایل ACCESSIBILITY.md وجود ندارد. یک کتابخانه کوچک، ابزار خط فرمان، سایت مستندات و یک برنامه وب بزرگ، کاربران، ریسک‌ها و ظرفیت نگهداری متفاوتی دارند. با اطلاعات دقیقی شروع کنید که پروژه بتواند آن را به‌روز نگه دارد.

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

انتظارات از مشارکت‌کنندگان: بررسی‌های دسترس‌پذیری، شواهد یا رویه‌های بازبینی مورد انتظار برای تغییرات را توضیح دهید، از جمله دستورالعمل‌هایی برای مشارکت‌کنندگان انسانی و عامل‌های کدنویسی.

گزارش موانع دسترس‌پذیری: مسیری مستقیم و در دسترس برای گزارش فراهم کنید. افشای ناتوانی، اسکرین‌شات یا ضبط را الزامی نکنید.

فرایند پاسخ: توضیح دهید نگه‌دارندگان چگونه مسائل دسترس‌پذیری را تأیید، اولویت‌بندی و دسته‌بندی (triage)، پیگیری و درباره آن‌ها اطلاع‌رسانی می‌کنند. اگر پروژه از سطوح شدت استفاده می‌کند، بگذارید نگه‌دارندگان آن‌ها را در مرحله اولویت‌بندی و دسته‌بندی تعیین یا تأیید کنند.

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

محدودیت‌های شناخته‌شده: موانع را بر اساس تجربه تحت تأثیر توصیف کنید، راه‌حل‌های موقت موجود را بیاورید و به کارهای پیگیری‌شده برای رفع مشکل پیوند دهید.

مالکیت و نگهداری: تیم، نقش یا نگه‌داری را نام ببرید که مسئول به‌روز نگه داشتن بیانیه و رویه‌های مرتبط است.

بازخورد و بهبودها: توضیح دهید کاربران و مشارکت‌کنندگان چگونه می‌توانند تغییر در بیانیه یا رویه‌های دسترس‌پذیری پروژه را پیشنهاد دهند.

به یاد داشته باشید که پروژه می‌تواند نسخه و سطحی از Web Content Accessibility Guidelines را به‌عنوان هدف تعیین کند. هدف، انطباق تأییدشده را اثبات نمی‌کند. ادعای انطباق نیازمند ارزیابی است و باید دامنه ارزیابی‌شده، تاریخ، روش و ارزیاب را مشخص کند.

مفیدترین فایل‌های ACCESSIBILITY.md چه چیزهایی دارند

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

راهنمایی مفید برای گزارش‌دهی، زمینه مرتبط را می‌طلبد؛ مانند کار یا صفحه تحت تأثیر، رفتار مشاهده‌شده، مرورگر، سیستم‌عامل و فناوری کمکی. اسکرین‌شات و ضبط را اختیاری می‌کند و از کسی نمی‌خواهد ناتوانی خود را اثبات کند.

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

گردش‌کار Insights > Community Standards در GitHub یک سند آغازین کوتاه‌تر با اعلان‌هایی فراهم می‌کند که پروژه‌ها می‌توانند آن‌ها را با اطلاعات خود جایگزین کنند. هدف این نیست که پیش از انتشار فایل، سیاستی بی‌نقص تولید شود. با اطلاعات دقیق شروع کنید، شکاف‌ها را نام ببرید و بیانیه را هم‌زمان با بلوغ رویه‌های دسترس‌پذیری پروژه به‌روز کنید.

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

Jan Maarten (او/او) طراح و متخصص دسترس‌پذیری است که در سرزمین‌های واگذارنشده Duwamish زندگی می‌کند. او دو دهه تجربه در طراحی محصول، برند، استراتژی و رهبری دارد. در GitHub، او طراحی و مهندسی را به هم پیوند می‌دهد تا محصولات در دسترس‌تر بسازد، زیرساخت سیستم طراحی را توسعه دهد و منابعی برای جامعه گسترده‌تر طراحی ایجاد کند، از جمله GitHub Annotation Toolkit متن‌باز.

Git به‌روزرسانی‌هایی منتشر می‌کند که شش آسیب‌پذیری امنیتی را در کلون‌های بازگشتی، مدیریت ارجاع، ادغام‌ها، وصله‌های دودویی و واردکردن‌ها برطرف می‌کند. آنچه کاربران باید بدانند این است.

رویداد سالانه یک‌ماهه بازی‌سازی GitHub برای چهاردهمین سال بازگشته است! امسال در نوامبر، بازی‌ای با الهام از موضوع SHIFT بسازید. دنده عوض کنید، دیدگاه‌ها را جابه‌جا کنید، واقعیت را خم کنید یا فقط یک کلید مشخص را فشار دهید.

ما خبرنامه هم داریم

نکته‌ها، راهنماهای فنی و بهترین رویه‌ها را در خبرنامه دوهفتگی ما، مخصوص توسعه‌دهندگان، کشف کنید.

منبع: GitHub Blog

متن و تصاویر اصلی از منبع بالا. ترجمه و ویرایش در دیجیتال سرآمد.