pkgbuilds/CONTRIBUTING.md
2024-08-12 15:14:52 +00:00

4.2 KiB
Raw Blame History

Contributing to Parch Linux PKGBUILD Repository

Thank you for considering contributing to the Parch Linux PKGBUILD repository! Your contributions help improve the community and the software we all use. Please follow the guidelines below to ensure a smooth contribution process.

How to Contribute

  1. Fork the Repository: Start by forking the repository to your own GitHub account.
  2. Clone Your Fork: Clone your forked repository to your local machine.
    git clone https://git.parchlinux.com/packages/pkgbuilds
    
  3. Create a Branch: Create a new branch for your feature or bug fix.
    git checkout -b my-feature-branch
    
  4. Make Changes: Make your changes to the PKGBUILD or related files.
  5. Commit Your Changes: Commit your changes with a clear message.
    git commit -m "Add new package or fix issue"
    
  6. Push to Your Fork: Push your changes to your forked repository.
    git push origin my-feature-branch
    
  7. Create a Pull Request: Go to the original repository and create a pull request from your branch.

If you do not wish to create a GitLab account, you can send your changes as a patch file. To create a patch, use the following command:

git format-patch origin/main

Then, send the generated .patch file to the maintainers.

Guidelines

  • Ensure that your PKGBUILD follows the Arch Linux packaging standards.
  • Test your PKGBUILD before submitting.
  • Provide a clear description of your changes in the pull request.

Code of Conduct

Please adhere to the Code of Conduct while contributing to this project.


مشارکت در مخزن سورس‌های بسته‌های پارچ لینوکس

از اینکه به مشارکت در مخزن سورس‌های بسته‌های پارچ لینوکس فکر می‌کنید، متشکریم! مشارکت‌های شما به بهبود جامعه و نرم‌افزاری که همه ما استفاده می‌کنیم، کمک می‌کند. لطفاً دستورالعمل‌های زیر را برای اطمینان از یک فرآیند مشارکت روان دنبال کنید.

چگونه مشارکت کنیم

  1. مخزن را Fork کنید: ابتدا مخزن را به حساب GitHub خود Fork کنید.
  2. Fork خود را Clone کنید: مخزن Fork شده را به ماشین محلی خود Clone کنید.
    git clone https://github.com/your-username/parch-linux-pkgbuild.git
    
  3. یک شاخه ایجاد کنید: یک شاخه جدید برای ویژگی یا اصلاح باگ خود ایجاد کنید.
    git checkout -b my-feature-branch
    
  4. تغییرات را اعمال کنید: تغییرات خود را در PKGBUILD یا فایل‌های مرتبط اعمال کنید.
  5. تغییرات خود را Commit کنید: تغییرات خود را با یک پیام واضح Commit کنید.
    git commit -m "اضافه کردن بسته جدید یا اصلاح مشکل"
    
  6. به Fork خود Push کنید: تغییرات خود را به مخزن Fork شده خود Push کنید.
    git push origin my-feature-branch
    
  7. یک Pull Request ایجاد کنید: به مخزن اصلی بروید و یک Pull Request از شاخه خود ایجاد کنید.

اگر نمی‌خواهید حساب گیت‌لب ایجاد کنید، می‌توانید تغییرات خود را به صورت فایل patch ارسال کنید. برای ایجاد یک patch، از دستور زیر استفاده کنید:

git format-patch origin/main

سپس، فایل .patch تولید شده را به نگهدارندگان ارسال کنید.

دستورالعمل‌ها

  • اطمینان حاصل کنید که PKGBUILD شما با استانداردهای بسته‌بندی Arch Linux مطابقت دارد.
  • PKGBUILD خود را قبل از ارسال آزمایش کنید.
  • در Pull Request خود توضیح واضحی از تغییرات خود ارائه دهید.

کد رفتار

لطفاً در حین مشارکت در این پروژه به کد رفتار پایبند باشید.