ডকুমেন্টেশন কন্ট্রিবিউশন
ওয়ার্ডপ্রেস প্লেগ্রাউন্ড ডকুমেন্টেশন সাইটটি আপনার মতো ভলেন্টিয়ার দ্বারাই পরিচালিত, যারা আপনার সাহায্য পেলে খুশি হবে।
সমস্ত ডকুমেন্টেশন-সম্পর্কিত ইস্যুগুলো লেবেল করা থাকে [Type] Documentation অথবা [Type] Developer Documentation ও WordPress/wordpress-playground রিপোজিটরিতে। খোলা ইস্যুগুলোর তালিকা ব্রাউজ করে আপনার পছন্দের একটি নিয়ে কাজ শুরু করুন। বিকল্পভাবে, যদি আপনি মনে করেন বর্তমান ডকুমেন্টেশনে কিছু অনুপস্থিত আছে, তাহলে আপনার প্রস্তাব নিয়ে আলোচনা করতে একটি নতুন ইস্যু খুলুন।
আমি কিভাবে কন্টিবিউট করতে পারি?
আপনি প্রজেক্ট রিপোজিটরিতে একটি ইস্যু খুলে এবং আপনি কী যোগ করতে বা পরিবর্তন করতে চান তা বর্ণনা করে কন্টিবিউট করতে পারেন।
যদি আপনার মনে হয়, তাহলে ইস্যুর বিবরণে কনটেন্টটি লিখে দিন এবং প্রকল্পের প্রজেক্ট কনট্রিবিউটররা বাকিটা দেখবে ।
আপনি কি আপনার ভাষায় ডকুমেন্টেশন দেখতে চান? চেক করুন ট্রান্সলেশন সেকশন।
রিপোটি ফর্ক করুন, ফাইলগুলো লোকালি এডিট করুন এবং একটি পুল রিকোয়েস্ট দিন
আপনি যদি মার্কডাউনের সাথে পরিচিত হন, তুমি রিপোটি ফর্ক করে wordpress-playground এ একটি পুল রিকোয়েস্ট জমা দিয়ে পরিবর্তন এবং নতুন ডকুমেন্টেশন পেজের প্রস্তাব করুন।
রিপোজিটরিতে ট্রান্সলেট পেজগুলি নিয়ে নতুন পুল খোলার জন্য একটি ব্রাঞ্চ তৈরির প্রক্রিয়া WordPress/wordpress-playground গুটেনবার্গের মতো অন্যান্য ওয়ার্ডপ্রেস রিপোজিটরিতে অবদান রাখার প্রক্রিয়ার মতো একই রকম: https://developer.wordpress.org/block-editor/contributors/code/git-workflow/
ডকুমেন্টেশন ফাইলগুলো (.md ফাইলগুলো) প্লেগ্রাউন্ডের গিটহাব রিপোজিটরিতে সংরক্ষণ করা হয়, under /packages/docs/site/docs ইংরেজির জন্য এবং /packages/docs/site/i18n অন্যান্য ভাষার জন্য।
ব্রাউজারে এডিট করুন
আপনি যদি গিটহাব এ লগইন করে থাকেন, তাহলে সরাসরি গিটহাব ইউআই থেকেই বিদ্যমান ফাইল এডিট করতে (বা নতুন ফাইল যোগ করতে) এবং একটি পুল রিকোয়েস্ট জমা দিতে পারবেন:
- যে পেজটি আপনি এডিট করতে চান সেটি খুঁজে নিন, অথবা যে অধ্যায়ের মধ্যে নতুন পেজ যোগ করতে চান, সেই ডিরেক্টরিটি সিলে ক্ট করুন।
- নতুন ফাইল যোগ করতে এড ফাইল বাটনে ক্লিক করুন, অথবা কোনো বিদ্যমান ফাইলে ক্লিক করে তারপর এডিট করতে পেন্সিল আইকনে ক্লিক করুন।
- গিটহাব আপনাকে রিপোজিটরিটি ফোর্ক করতে এবং আপনার পরিবর্তনগুলি দিয়ে একটি নতুন ব্রাঞ্চ তৈরি করতে বলবে।
- একটি এডিটর খুলবে যেখানে আপনি পরিবর্তনগুলি করতে পারবেন।
- আপনার কাজ শেষ হলে, কমিট পরিবর্তন বাটনে ক্লিক করুন এবং একটি পুল রিকোয়েস্ট সাবমিট করুন।
এটাই! আপনি মাত্রই ওয়ার্ডপ্রেস প্লেগ্রাউন্ড ডকুমেন্টেশনে কন্টিবিউট করেছেন।
এই পদ্ধতিতে আপনাকে রিপোজিটরি ক্লোন করতে হবে না, লোকাল ডেভেলপমেন্ট এনভায়রনমেন্ট সেটআপ করতে হবে না, কিংবা কোনো কমান্ড চালাতেও হবে না।
খারাপ দিক হল আপনি আপনার পরিবর্তনগুলি প্রিভিউ করতে পারবেন না। পুল রিকোয়েস্ট জমা দেওয়ার আগে আপনার পরিবর্তনগুলি কীভাবে পর্যালোচনা করব েন তা জানতে পড়তে থাকুন।
লোকাল প্রিভিউ
রিপোজিটরিটি ক্লোন করুন এবং আপনার ডিভাইসের ডিরেক্টরিতে নেভিগেট করুন। এখন নিম্নলিখিত কমান্ডগুলি চালান:
npm install
npm run build:docs
npm run dev:docs
ডকুমেন্টেশন সাইটটি একটি নতুন ব্রাউজার ট্যাবে খোলে এবং প্রতিটি পরিবর্তনের সাথে স্বয়ংক্রিয়ভাবে রিফ্রেশ হয়। আপনার কোড এডিটরে প্রাসঙ্গিক ফাইলটি এডিট করা চালিয়ে যান এবং রিয়েল-টাইমে পরিবর্তনগুলি পরীক্ষা করুন।