এই বিভাগটি সেইসব আর্থ ইঞ্জিন ব্যবহারকারীদের জন্য উৎসর্গীকৃত, যারা আর্থ ইঞ্জিন কমিউনিটির বাকিদের সাথে নিজেদের জ্ঞান ভাগ করে নিতে চান। আর্থ ইঞ্জিন ব্যবহারকারীদের দ্বারা, ব্যবহারকারীদের জন্যই তৈরি এই বিভাগের টিউটোরিয়ালগুলো একেবারে নতুন থেকে শুরু করে অভিজ্ঞ ব্যবহারকারী পর্যন্ত সকল স্তরের জন্য উপযোগী।
টিউটোরিয়ালগুলো মার্কডাউন মার্কআপ ল্যাঙ্গুয়েজে ফরম্যাট করা সাধারণ টেক্সট ও কোড হিসেবে, অথবা মার্কডাউন ও এক্সিকিউটেবল পাইথন কোড সম্বলিত কোলাব নোটবুক হিসেবে জমা দেওয়া যেতে পারে। আর্থ ইঞ্জিন জাভাস্ক্রিপ্ট ক্লায়েন্ট লাইব্রেরি ব্যবহার করে তৈরি টিউটোরিয়ালগুলো সাধারণত মার্কডাউনে লেখা হয়, অন্যদিকে আর্থ ইঞ্জিন পাইথন ক্লায়েন্ট লাইব্রেরির উপর ভিত্তি করে তৈরি টিউটোরিয়ালের জন্য কোলাব ব্যবহারের পরামর্শ দেওয়া হয়।
শুরু করার আগে
আচরণবিধি
আর্থ ইঞ্জিন টিম একটি হয়রানিমুক্ত ও অন্তর্ভুক্তিমূলক কমিউনিটি গড়ে তুলতে প্রতিশ্রুতিবদ্ধ। অবদান রাখার আগে অনুগ্রহ করে আমাদের আচরণবিধি পড়ে নিন।
গিটহাবে যোগদান
আর্থ ইঞ্জিন কমিউনিটির টিউটোরিয়ালগুলো গিটহাবের মাধ্যমে শেয়ার ও পর্যালোচনা করা হয়। যদি আপনার আগে থেকে গিটহাব অ্যাকাউন্ট না থাকে, তবে আপনাকে প্রথমে https://github.com/join-এ গিয়ে একটি অ্যাকাউন্ট তৈরি করতে হবে।
একটি টিউটোরিয়াল প্রস্তাব করা
একটি নতুন টিউটোরিয়ালে উল্লেখযোগ্য সময় ও শ্রম বিনিয়োগ করার আগে, সম্ভাব্য অবদানকারীদের কিছু প্রাথমিক তথ্যসহ একটি সাধারণ প্রস্তাব জমা দিতে বলা হয়। এর ফলে লেখকরা আর্থ ইঞ্জিন ডেভেলপার ডকুমেন্টেশনের রক্ষণাবেক্ষণকারীদের সাথে কাজ করে সেইসব টিউটোরিয়ালের উপর মনোযোগ দিতে পারেন, যা আর্থ ইঞ্জিন ব্যবহারকারী সম্প্রদায়ের জন্য সর্বাধিক মূল্যবান। এটি পর্যালোচনা প্রক্রিয়ার সময় সম্ভাব্য বারবার আলোচনা এড়িয়ে সময়ও বাঁচায়।
একটি টিউটোরিয়াল প্রস্তাব করুন
প্রথমবার সেটআপ
আপনি যদি প্রথমবারের মতো আর্থ ইঞ্জিন কমিউনিটি গিটহাব রিপোজিটরিতে কোনো টিউটোরিয়াল জমা দিয়ে থাকেন, তাহলে আপনার টিউটোরিয়ালের কাজ শুরু করার আগে এই ধাপগুলো অবশ্যই সম্পন্ন করুন:
এখানে অবদানকারী লাইসেন্স চুক্তি (CLA) গ্রহণ করুন:
https://cla.developers.google.com
কমিউনিটি টিউটোরিয়াল স্টাইল গাইডটি পড়ুন এবং আত্মস্থ করুন।
একটি টিউটোরিয়াল লেখা এবং জমা দেওয়া
একবার আপনার টিউটোরিয়াল প্রস্তাবটি রক্ষণাবেক্ষণকারীদের দ্বারা গৃহীত হলে, টিউটোরিয়ালটি সম্পাদনা করার এবং আর্থ ইঞ্জিন কমিউনিটি রিপোজিটরিতে জমা দেওয়ার জন্য বেশ কয়েকটি বিকল্প রয়েছে:
মার্কডাউন দ্রুত শুরু
আপনি গিটহাব রিপোজিটরিটি ফর্ক করতে পারেন এবং কোনো অতিরিক্ত টুল বা সেটআপ ছাড়াই দ্রুত কাজ শুরু করার জন্য সরাসরি গিটহাব ওয়েবসাইটের মাধ্যমে একটি নতুন টিউটোরিয়াল তৈরি করতে পারেন:
যদি আগে থেকে সাইন ইন না করে থাকেন, তাহলে গিটহাবে সাইন ইন করুন ।
নতুন টিউটোরিয়াল ফাইল তৈরি ও সম্পাদনা করতে, ' নতুন টিউটোরিয়াল' (New tutorial) -এ ক্লিক করুন। প্রয়োজনে, আপনাকে রিপোজিটরিটি ফোর্ক (fork) করার জন্য অনুরোধ করা হবে।
ফর্মটির টিউটোরিয়াল ফাইলের জন্য একটি নাম লিখুন:
your-tutorial-name/index.mdযেখানে
your-tutorial-nameহলো আপনার টিউটোরিয়ালের সংক্ষিপ্ত নাম, যা সম্পূর্ণ ছোট হাতের অক্ষরে লিখতে হবে। শব্দগুলো আলাদা করতে ড্যাশ ("-") ব্যবহার করুন। ফোল্ডারের নামে কোনো স্পেস বা অন্য কোনো যতিচিহ্ন ব্যবহার করবেন না।আপনার টিউটোরিয়ালটি সরাসরি গিটহাব ফাইল এডিটরে সম্পাদনা করুন এবং ফরম্যাট করা আউটপুট যাচাই করতে 'প্রিভিউ' ব্যবহার করুন (গিটহাব ডকুমেন্টেশনে আপনার রিপোজিটরিতে ফাইল সম্পাদনা করার পদ্ধতিও দেখুন)।
প্রস্তুত হয়ে গেলে, আপনার পরিবর্তনগুলো কমিট করুন এবং একটি পুল রিকোয়েস্ট খুলুন।
কোলাব নোটবুক
কোলাবে টিউটোরিয়াল লেখা শুরু করতে এখানে ক্লিক করুন:
এটি একটি নোটবুক খুলবে, যেখানে আপনার টিউটোরিয়ালটি তৈরি ও জমা দেওয়ার নির্দেশাবলী থাকবে।
উন্নত
আপনি যদি আগে থেকেই গিটহাব, গিট এবং সংশ্লিষ্ট টুলগুলোর সাথে পরিচিত থাকেন, তাহলে মার্কডাউন এবং কোলাব উভয় টিউটোরিয়াল জমা দেওয়ার সামগ্রিক প্রক্রিয়া একই:
google/earthengine-community গিটহাব রিপোজিটরিটি ফর্ক এবং ক্লোন করুন।
tutorialsঅধীনে আপনার টিউটোরিয়ালের সংক্ষিপ্ত নামটি দিয়ে একটি ডিরেক্টরি তৈরি করুন (যেমন,tutorials/my-amazing-tutorial)।টিউটোরিয়ালটি নতুন ডিরেক্টরিতে
index.md(মার্কডাউনের জন্য) অথবাtutorial.ipynb(কোলাবের জন্য) ফাইলনামে কমিট করুন। টিউটোরিয়ালে ব্যবহৃত ছবিগুলোও একই ডিরেক্টরিতে কমিট করুন।নতুন কন্টেন্টটি আপনার ফর্কে পুশ করুন এবং একটি পুল রিকোয়েস্ট খুলুন ।
পুল রিকোয়েস্ট তৈরি করার সময়, কমেন্ট সেকশনে মূল প্রস্তাবনাটির গিটহাব ইস্যু নম্বর উল্লেখ করতে ভুলবেন না। উদাহরণস্বরূপ, যদি ইস্যুটি #123 হয়, তাহলে মূল প্রস্তাবনাটির উল্লেখ করার জন্য এবং টিউটোরিয়ালটি প্রকাশিত হওয়ার সাথে সাথে এটিকে স্বয়ংক্রিয়ভাবে সম্পন্ন হিসেবে চিহ্নিত করার জন্য, আপনাকে পুল রিকোয়েস্টের বিবরণে "Closes #123" লেখাটি রাখতে হবে।
আপনি একটি পুল রিকোয়েস্ট খোলার পর, আপনার সাবমিশনটি পর্যালোচনা করার জন্য এক বা একাধিক মেইনটেইনারকে নিযুক্ত করা হবে। পর্যালোচক(গণ) আপনার সাথে কাজ করে নিশ্চিত করবেন যে আপনার সাবমিশনটি সম্পূর্ণ, সঠিক এবং ‘আর্থ ইঞ্জিন কমিউনিটি টিউটোরিয়াল স্টাইল গাইড’-এর সাথে সামঞ্জস্যপূর্ণ।
আপনার পুল রিকোয়েস্ট অনুমোদিত হয়ে গেলে, রিপোজিটরি রক্ষণাবেক্ষণকারীরা আপনার টিউটোরিয়ালটি প্রকাশ করবেন।