پروژه Project Guidelines مجموعهای جامع از بهترین شیوهها برای توسعه پروژههای جاوااسکریپت است که توسط Elsewhen ↗ در گیتهاب ↗ منتشر شده است. این دستورالعملها شامل توصیههایی در زمینههای مختلفی مانند استفاده از گیت، مستندسازی، محیطهای توسعه، وابستگیها، تست، ساختار و نامگذاری، سبک کدنویسی، طراحی API، امنیت API، مستندسازی API، دسترسپذیری و مجوزها میباشد.
این پروژه با ارائه راهنماییهای دقیق در مورد استفاده از گیت، به توسعهدهندگان کمک میکند تا با استفاده از feature branches و انجام بازبینیهای تعاملی (interactive rebasing)، فرآیند توسعه را بهبود بخشند. همچنین، توصیههایی در مورد نوشتن پیامهای کامیت (commit messages) بهطور مؤثر ارائه میدهد که به مستندسازی و ردیابی بهتر تغییرات کمک میکند.
علاوه بر این، دستورالعملهایی برای ایجاد محیطهای توسعهی یکنواخت، مدیریت وابستگیها، انجام تستها، نامگذاری ساختارها و کدنویسی با استایلهای مشخص ارائه میدهد. این دستورالعملها به توسعهدهندگان کمک میکند تا پروژههای خود را با کیفیت بالاتر و کارایی بیشتر توسعه دهند.
با افتخار در این پروژه مشارکت داشتم و با ترجمهی کامل مستندات آن به زبان فارسی، به گسترش دسترسی توسعهدهندگان فارسیزبان به این منابع ارزشمند کمک کردهام. این ترجمه در فایل README-ir.md ↗ موجود است و به توسعهدهندگان فارسیزبان این امکان میدهد تا با مطالعه این مستندات، از بهترین شیوههای توسعه پروژههای جاوااسکریپت بهرهمند شوند. ترجمه اولیه این پروژه در تاریخ 19 آذر 1403 به پایان رسید ولی مجدد در تاریخ 3 بهمنماه 1403 مورد بازبینی و بهروزرسانی قرار گرفت تا از دقت و هماهنگی بیشتری برخوردار شود. اکنون میتوانید ترجمه نهایی را از طریق لینک پروژه در گیتهاب ↗ و یا این بلاگ مورد مطالعه قرار دهید.
امیدوارم این تلاش کوچک، گامی مؤثر در بهبود کیفیت پروژههای نرمافزاری و تسهیل فرآیند توسعه در جامعهی برنامهنویسان باشد.