منابع مستندات
این یک نمای کلی از منابع مستندات برای Nix، Nixpkgs و NixOS است، به همراه پیشنهادهایی دربارهی اینکه چگونه میتوانید به بهبود آنها کمک کنید.
راهنماهای مرجع
راهنماهای مرجع، رابطها و رفتارها را مستند میکنند، مثالها را نشان میدهند و اصطلاحات مختص کامپوننت را تعریف میکنند.
بخشهای مربوط به هر راهنما توسط توسعهدهندگان کدی که در حال مستندسازی است، نگهداری میشوند.
چگونه کمک کنید:
- افزودن پیوند به تعاریف، دستورات، گزینهها و غیره در مواردی که فقط نام ذکر شده است
- اطمینان از استفادهی سازگار از اصطلاحات فنی
- بررسی اینکه مثالها خودمحور/خودمختار هستند و از بهترین روشها پیروی میکنند
- گسترش بخشهایی که ناقص به نظر میرسند
ویکی NixOS
ویکی NixOS مجموعهای از راهنماهای کاربر NixOS، نمونههای پیکربندی و نکات عیبیابی است. این ویکی به عنوان مکمل راهنمای مرجع NixOS در نظر گرفته شده است.
این ویکی به صورت جمعی توسط جامعهی کاربران NixOS ویرایش میشود.
چگونه کمک کنید:
- بهبود قابلیت کشف با افزودن دستهبندیها و پیوندها به مستندات مرجع
- حذف اطلاعات اضافی یا منسوخشده
- افزودن راهنماها و پیکربندیهای نمونه برای موارد استفادهی خود
سایت nix.dev
هدف nix.dev (کد منبع) راهنمایی افراد مبتدی در بومسازگان Nix است.
تیم مستندات، nix.dev را به عنوان ویراستار مدیریت و نگهداری میکند.
چگونه کمک کنید:
کار روی مسائل باز
بررسی درخواستهای کشش
افزودن راهنماها یا آموزشها بر اساس طرح پیشنهادی. مقالات جدید میتوانند بر اساس ویدیوهایی مانند موارد زیر باشند:
- ضبطهای ساعت نیکس (The Nix Hour)
- برخی از حدود ۱۰۰ ضبط NixCon
- راهنماهای ویدیویی Nix توسط @jonringer.
- تکگفتارهای تابستان نیکس ۲۰۲۲ (Summer of Nix 2022 talks)
از آنجا که نوشتن یک راهنما یا آموزش کار زیادی میبرد، لطفاً حتماً با نگهدارندگان هماهنگ کنید؛ مثلاً با ثبت نظر یا ایجاد یک مسئله (Issue).
دیسکورس (Discourse)
کاربران Nix در این دستهبندیهای دیسکورس اطلاعات خود را مبادله کرده و به یکدیگر کمک میکنند:
نحوه کمک کردن:
- پرسیدن سوالات آگاهانه، نشان دادن تلاشها و کارهای انجامشده
- پاسخ دادن به سوالات دیگران
- پاسخگویی به سوالات پرتکرار با بهروزرسانی یا افزودن یک مقاله در ویکی NixOS، یک راهنما یا آموزش در nix.dev، یا یکی از کتابچههای راهنمای مرجع.
- تشویق و کمک به افراد برای گنجاندن بینشهای خود در مستندات رسمی
قرصهای Nix (Nix Pills)
قرصهای Nix مجموعهای از آموزشهای سطح پایین درباره ساخت بستههای نرمافزاری با Nix است که به طور مفصل نشان میدهد Nixpkgs چگونه از اصول اولیه ساخته شده است.
قرصهای Nix به طور فعال نگهداری نمیشوند.