پیشنمایش مستندات تازهٔ Node.js اومد
نود جیاس
جاوااسکریپتخلاصهٔ کاملتر
تو اعلان رسمی نود جیاس اومده که تیم وب این پروژه سیستم تولید و نمایش مستندات API رو از پایه بازنویسی کرده و نسخهٔ پیشنمایشش الان روی beta.docs.nodejs.org در دسترسه. به گفتهٔ نویسنده، قبل از اینکه این نسخه پیشفرض بشه، میخوان آدمهای بیشتری باهاش کار واقعی بکنن و بازخورد بدن. محتوای صفحهها هیچ فرقی نکرده و هنوز از همون فایلهای Markdown مخزن nodejs/node ساخته میشه.
چیزهایی هم که بهشون عادت کردی سر جاشونن: تم روشن و تیره، سوییچ بین ESM و CJS، دکمهٔ کپی روی نمونهکدها، نشانهای پایداری، تاریخچهٔ نسخهها و نسخهٔ Markdown هر صفحه. اما بازطراحی فقط ظاهری نبوده؛ ناوبری، چیدمان و خوانایی هم دوباره طراحی شدن تا پیدا کردن و فهمیدن یه API کمزحمتتر باشه.
مهمترین چیز تازه، جستوجوی داخلیه که مستندات API تا حالا نداشت: یه باکس جستوجو تو همهٔ صفحهها با میانبر کیبورد، که دیگه لازم نیست برای رسیدن به یه بخش از API سر بزنی به موتور جستوجو. کنارش مستندات حالا از همون دیزاینسیستم سایت nodejs.org استفاده میکنه: سایدبار همیشگی با فهرست همهٔ ماژولها، فهرست مطالب همیشهپیدای هر صفحه و چیدمانی که روی نمایشگر کوچیک هم کار میکنه.
فایل llms.txt هم منتشر شده تا ابزارهای هوش مصنوعی یه ورودی تمیز و ساختارمند به مرجع API داشته باشن، و چیزهایی مثل زمان مطالعه و نوار اعلان هم اضافه شدن. صفحهها حتی با جاوااسکریپت غیرفعال و آفلاین قابل استفاده میمونن. پشت صحنه همهٔ اینها با doc-kit ساخته شده؛ ابزاری مستقل که خود پروژهٔ نود جیاس درست کرده تا جایگزین ژنراتور قدیمی بشه و بازخوردها و باگها هم تو همون مخزن nodejs/doc-kit پیگیری میشه.
نکات کلیدی:
- پیشنمایش مستندات تازهٔ API روی beta.docs.nodejs.org در دسترسه
- محتوا همون فایلهای Markdown مخزن nodejs/node ـه و تغییری نکرده
- جستوجوی داخلی برای اولینبار به مستندات API اضافه شده
- دیزاینسیستم مشترک با nodejs.org، سایدبار ماژولها و فهرست مطالب هر صفحه
- llms.txt برای ابزارهای هوش مصنوعی منتشر شده
- موتور جدید doc-kit ـه، جایگزین ژنراتور قدیمی مستندات
- بازخوردها و گزارش باگ تو مخزن nodejs/doc-kit جمع میشه
