در ساخت بزرگ‌ترین مرجع فارسی لینوکس مشارکت کنید
لینوکس‌داک پروژه‌ای رایگان و متن‌باز است که با کمک جامعه رشد می‌کند. هر مشارکتی — از اصلاح یک تایپ تا نوشتن آموزش کامل — به ما کمک می‌کند تا لینوکس را برای فارسی‌زبانان قابل‌دسترس کنیم.
زمینه‌های مشارکت
نوشتن آموزش
آموزش جدیدی برای Gentoo یا توزیع‌های بعدی بنویسید. قالب MDX و راهنمای استایل آماده است.
اصلاح و بهبود
اشتباهات تایپی، اطلاعات قدیمی یا توضیحات ناکافی را اصلاح کنید. هر اصلاح کوچکی ارزشمند است.
ترجمه
مستندات انگلیسی رسمی را به فارسی روان و دقیق ترجمه کنید و منابع را ذکر کنید.
گزارش خطا
اگر خطا یا مشکل فنی در سایت یا محتوا دیدید، در گیت‌هاب گزارش کنید.
توسعه کد
در توسعه امکانات سایت (جستجو، کامپوننت‌ها، عملکرد، SEO) مشارکت کنید.
پیشنهاد ایده
ایده‌ای برای بهبود پروژه دارید؟ آن را در بخش Issues مطرح کنید.
گردش کار مشارکت
۱. مخزن را فورک کنید
ابتدا یک حساب گیت‌هاب بسازید و مخزن پروژه را Fork کنید.
git clone https://github.com/HojatJoshani/linuxdoc.git۲. شاخه جدید بسازید
برای هر تغییر، یک شاخه جدید با نام توصیفی ایجاد کنید.
git checkout -b add/docker-doc۳. تغییرات را اعمال کنید
فایل MDX را در مسیر src/content/<distro>/ ویرایش یا بسازید (مثلاً gentoo/ یا arch/ یا course/). قالب frontmatter را رعایت کنید.
۴. به‌صورت محلی تست کنید
پروژه را اجرا کنید و تغییر خود را بررسی کنید.
bun install && bun run dev۵. کامیت و Push
تغییرات را با پیام واضح کامیت و به مخزن خود Push کنید.
git commit -m "docs: add Docker installation guide"۶. Pull Request بفرستید
از گیت‌هاب یک Pull Request به مخزن اصلی بفرستید. توضیحات کامل بنویسید.
قالب استاندارد MDX
برای نوشتن آموزش جدید، از این قالب استفاده کنید:
---
title: "عنوان آموزش"
description: "توضیح کوتاه یک‌خطی"
difficulty: "مقدماتی" # یا متوسط | پیشرفته
readingTime: 8
updated: "2026-04-01"
tags: ["gentoo", "نصب"]
---
## شروع
متن آموزش اینجا...
```bash
# دستور با کامنت خروجی
emerge --ask sys-kernel/gentoo-sources
```
<Callout type="tip" title="نکته">
محتوای نکته
</Callout>
## خطاهای رایج
### خطا: توضیح
راه‌حل...
## مرحله بعد
برای ادامه، [آموزش مرتبط](/docs/gentoo/...) را ببینید.
راهنمای نگارش
- تمام محتوا فارسی باشد؛ نام دستورات و کد انگلیسی بماند.
- اعداد در متن فارسی، اعداد داخل کد لاتین.
- هر آموزش شامل: مقدمه، پیش‌نیازها، مراحل، خطاهای رایج و لینک مرتبط باشد.
- از کامپوننت Callout برای نکته/هشدار/خطر استفاده کنید.
- تمام دستورات را با کامنت خروجی همراه کنید تا کاربر بداند چه انتظاری داشته باشد.
- حقایق فنی دقیق و قابل‌اعتماد باشند؛ منابع رسمی Gentoo ملاک هستند.
- بدون `<` یا `>` خام در متن معمولی (در کد مشکلی نیست) — MDX آن‌ها را JSX تفسیر می‌کند.
- بدون `{` یا `}` خام در متن معمولی (در کد مشکلی نیست).
گزارش باگ و پیشنهاد
گزارش باگ
اگر در سایت یا محتوا خطا، اشتباه یا مشکلی دیدید، آن را در بخش Issues گیت‌هاب گزارش کنید تا سریعاً بررسی کنیم.
باز کردن Issueپیشنهاد قابلیت
ایده‌ای برای بهبود سایت یا افزودن آموزش جدید دارید؟ آن را با برچسبenhancementمطرح کنید.
آماده شروع هستید؟
نخستین Pull Request خود را بفرستید. ما از هر مشارکتی استقبال می‌کنیم و در بررسی سریع آن تلاش می‌کنیم. برای راهنمای کامل، فایلCONTRIBUTING.mdرا بخوانید.