19.1. چگونه در توسعه کتاب دیتائیست مشارکت کنیم؟
پروژه دیتائیست فراتر از یک توزیع ساده، تلاش جمعی ما برای ساخت مرجعی زنده و کاربردی برای متخصصان داده و لینوکس است. از آنجایی که تکنولوژیها و ابزارها با سرعت در حال تغییر هستند، دانش شما – به عنوان کاربر و توسعهدهنده – بهترین سرمایه برای بهروز نگه داشتن این کتاب است.
اگر میخواهید بخشی از این مسیر باشید، این راهنما به شما نشان میدهد چطور میتوانید مشارکت کنید.
19.1.1. حوزههای اصلی مشارکت
اصلاح مستندات: آیا غلط تایپی یا جملهای مبهم پیدا کردید؟ اصلاحات شما به درک بهتر دیگران کمک میکند.
بهبود کدهای نمونه: اگر میدانید کدی را میتوان بهینهتر نوشت یا مثال کاربردیتری برای یک ابزار وجود دارد، استقبال میکنیم.
پیشنهاد سناریوهای CTF: چالشهای عملی قلب تپنده دیتائیست هستند. اگر ایدهای برای یک سناریوی لینوکسی دارید، با ما در میان بگذارید.
تکمیل بخشهای ناتمام: برخی از بخشهای کتاب هنوز در حال رشد هستند و جای کار دارند.
19.1.2. فرآیند گامبهگام مشارکت
مشارکت در دیتائیست بر پایه استانداردهای گیت (Git) است:
فورک (Fork): ابتدا مخزن اصلی پروژه را در گیتهاب یا گیتلب فورک کنید.
شاخه جدید (Branch): یک شاخه (Branch) با نام توصیفی برای تغییر خود بسازید.
ویرایش فایلهای .rst: تغییرات خود را مستقیماً در فایلهای با پسوند .rst اعمال کنید.
ارسال (Pull Request): در نهایت یک Pull Request ارسال کنید تا تغییرات توسط تیم هسته بررسی و ادغام شود.
19.1.3. قوانین ساده ما
لحن شفاف: تلاش کنید لحن نوشتهها آموزشی و فنی باقی بماند.
پایبندی به استایل: کدهای خود را حتماً داخل .. code-block:: قرار دهید تا با استایل کتاب یکپارچه باشد.
تست نهایی: پیش از ارسال، اگر امکان دارید دستور make html را اجرا کنید تا از صحت لینکها مطمئن شوید.
19.1.4. قدردانی از شما
هر مشارکتکنندهای که تغییری در مسیر رشد کتاب ایجاد کند، نامش به عنوان عضوی از خانواده دیتائیست ثبت خواهد شد. پیشاپیش از وقتی که برای اعتلای دانش فنی جمعی میگذارید، سپاسگزاریم.
آماده شروع هستید؟ به مخزن پروژه در [لینک مخزن] بروید و اولین Pull Request خود را ثبت کنید!