تیم متا در به‌روزرسانی مستندات React کار خارق‌العاده‌ای انجام داده و نسخه بتای مستندات React را برای کاربران ایجاد کرده است: https://beta.reactjs.org.

React (که به عنوان React.js یا ReactJS نیز شناخته می‌شود)، یک کتابخانه جاوا اسکریپت فرانت‌اند رایگان و منبع باز برای ساخت رابط‌های کاربری بر اساس مؤلفه‌های UI است. در حالی که React در اصل توسط جردن واک نوشته شده بود، توسط تیم متا (فیسبوک سابق) و جامعه ای متشکل از هزاران مشارکت کننده منبع باز نگهداری می شود. متا در حال به‌روزرسانی مستندات React است و یک وب سایت بتا منتشر کرده است که در اختیار گروهی از کاربران قرار داده شده است تا در شرایط واقعی آن را امتحان کنند. متا بازخورد کاربران را برای به روز رسانی اسناد جمع آوری می‌کند. وب‌سایت React Beta در نهایت به وب‌سایت اصلی React تغییر می‌کند. وب‌سایت قدیمی React نیز در یک زیر دامنه بایگانی می‌شود تا همچنان در دسترس باشد.

متا تصمیم گرفته است تا مستندات React را به‌روزرسانی و نسخه بتای مستندات React را منتشر کند، زیرا React Hooks به طور فزاینده‌ای محبوب شده‌اند ولی مستندات فعلی بر روی کامپوننت های کلاسی (class components) متمرکز شده‌اند. در ابتدا راشل نابورس و دن آبراموف (و سیلویا وارگاس که کد نمونه را ایجاد می‌کند)، محتوای جدید را ایجاد خواهند کرد تا به شیوه‌ای ثابت در سراسر مستندات دست یابند، اما بعداً طبق معمول از مشارکت‌ کنندگان کمک خواهند گرفت. توسعه‌دهندگان متا می‌خواهند «از لحظه‌ای که اولین کامپوننت خود را می‌سازید، در کنار شما باشند، تا زمانی که دانش React شما عمیق‌تر می‌شود، پیشرفت می‌کنید و وارد حرفه‌تان می‌شوید» و می‌خواهند که React برای همه نوع یادگیرندگان قابل دسترسی باشد.

نسخه بتای مستندات React در چه مواردی گسترش خواهد یافت؟

•  بازنویسی توضیحات با استفاده از Hooks به جای کلاس ها.
• توضیح مفاهیم برنامه نویسی پیچیده تر برای مبتدیان.
• پشتیبانی از سبک های مختلف یادگیری:
  •  بصری : برای یادگیرندگانی که ترجیح می‌دهند از تصاویر و درک فضایی با افزودن نمودارها و توضیحات بصری استفاده کنند.

نمونه ای از نمودارها از نسخه بتای مستندات React برای یادگیرندگان بصری:

• • فیزیکی: برای یادگیرندگانی که ترجیح می‌دهند مثال ها و تمرین ها را با افزودن نمونه‌های کد تعاملی انجام دهند.

نمونه ای از کدهای تعاملی از نسخه بتای مستندات React برای یادگیرندگان فیزیکی:

• آماده سازی یادگیرندگان برای اشکال زدایی (debugging) برنامه های واقعی با ادغام استفاده از React DevTools و قوانین قدیمی.
• افزودن راهنماها شامل چالش ها (با راه حل) برای بررسی درک کاربران.

نحوه ارائه بازخورد

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

https://beta.reactjs.org/#how-can-i-provide-feedback

همچنین یک دکمه بازخورد در گوشه سمت چپ پایین صفحه وجود دارد. این دکمه یک کادر پاپ آپ را برای ارائه رتبه و سپس گزینه‌ای برای ارائه بازخورد کتبی باز می‌کند.

روز و شب / حالت روشن و تاریک

نسخه بتای مستندات React دارای یک ویژگی عالی است که به کاربر این امکان را می‌دهد تا با کلیک بر روی دکمه ای در سمت چپ بالای وب سایت، حالت روز یا شب را انتخاب کنند.

در حالی که متن تیره در پس‌زمینه روشن بیشتر برای خوانایی و فوکوس بهتر در طول روز استفاده می‌شود، متن روشن روی پس‌زمینه‌ی تاریک می‌تواند برای برنامه‌نویسان مفید باشد. زیرا هرچه زمان بیشتری برای خواندن یا نوشتن در مقابل صفحه نمایش صرف شود، فشار بیشتری بر چشمان ما وارد می‌کند.

منبع:

https://medium.com/@michellemcgee2017/new-amazing-react-docs-beta-5a4a3d18a48b