কাজের পণ্য জমা দেওয়ার নির্দেশিকা

চূড়ান্ত মূল্যায়নের অংশ হিসাবে, সমস্ত অংশগ্রহণকারী অবদানকারীদের অবশ্যই প্রোগ্রামের জন্য তাদের করা কাজের একটি লিঙ্ক প্রদান করতে হবে। এটি সঠিকভাবে করতে ব্যর্থ হলে প্রোগ্রামটি ব্যর্থ হতে পারে । এটি করার বিভিন্ন উপায় রয়েছে, তাই দয়া করে এই নথিটি সাবধানে পড়ুন।

এই লিঙ্কগুলি GSoC প্রকল্পগুলির পাবলিক আর্কাইভে প্রকাশিত হবে৷ তারা প্রোগ্রামের সময় যে কাজটি করা হয়েছিল তা প্রদর্শন করতে সহায়তা করে। ভবিষ্যতে নিয়োগকর্তাদের জন্য আপনার কাজের কথা উল্লেখ করার জন্য এগুলি আপনার জন্য একটি দুর্দান্ত উপায়। আপনি চান যে লোকেরা আপনার প্রকল্পের লক্ষ্যগুলি কী ছিল, আপনি কী অর্জন করেছেন, আপনার কোডটি কোথায় এবং পরবর্তী যেকোনো সম্ভাব্য পদক্ষেপগুলি দ্রুত বুঝতে সক্ষম হবেন৷

বিগত বছরগুলিতে আমরা যে সেরা উদাহরণগুলি দেখেছি তা একটি "চূড়ান্ত প্রতিবেদন" এর মতো দেখায় যাতে রয়েছে:

  • প্রকল্পের লক্ষ্যগুলির একটি সংক্ষিপ্ত বিবরণ।
  • আপনি কি করেছেন.
  • বর্তমান অবস্থা।
  • কি করা বাকি আছে.
  • কি কোড আপস্ট্রিম একত্রিত হয়েছে (বা না)।
  • প্রজেক্টের সময় আপনি যে কোন চ্যালেঞ্জ বা গুরুত্বপূর্ণ জিনিস শিখেছেন।

উদাহরণগুলি দেখতে, 2022 প্রকল্পের তালিকা থেকে শুরু করুন, এলোমেলোভাবে প্রকল্পগুলি বাছাই করুন এবং তারপরে কোড দেখুন ক্লিক করুন৷ অনুগ্রহ করে মনে রাখবেন যে এই প্রকল্পগুলির মধ্যে অনেকগুলি আমাদের পরামর্শগুলি অনুসরণ করেনি, যার অর্থ শুধুমাত্র তাদের কাজ দেখাতে সক্ষম হওয়ার জন্য তাদের ক্ষতি করে।

অবদানকারীর জন্য দ্রষ্টব্য: একবার আপনি আপনার চূড়ান্ত কাজের জমা দেওয়ার পরে, আপনি আপনার চূড়ান্ত কাজের জমা দেওয়ার সময়সীমা পর্যন্ত এটি সম্পাদনা করতে পারেন।

আপনার মূল্যায়ন জমা দেওয়ার আগে আপনার পরামর্শদাতার সাথে আপনার লিঙ্কটি শেয়ার করা উচিত যাতে এটি তাদের প্রত্যাশা পূরণ করে।

প্রয়োজনীয়তা

  • আপনি যে কাজটি করেছেন তা সনাক্ত করা সহজ হতে হবে। (যেমন আপনার করা পরিবর্তন বা নতুন কোড।)
    • যখন কেউ প্রদত্ত URL-এ যায় তখন তা স্পষ্ট হওয়া উচিত যে আপনি তাদের উল্লেখযোগ্য অতিরিক্ত খনন করার প্রয়োজন ছাড়াই কী কাজ করেছেন৷
  • এটি একটি স্থিতিশীল অবস্থানে হওয়া উচিত। জমা দেওয়ার পরে URL পরিবর্তন করা যাবে না।
  • অন্য কেউ আপনার কাজ প্রসারিত করার জন্য লিঙ্কের লক্ষ্যে (বা এর থেকে উল্লেখ করা) বিষয়বস্তু ব্যবহার করতে সক্ষম হওয়া উচিত।
    • আপনার কাজ 100% সম্পূর্ণ হলে, তারা এটি ব্যবহার করতে সক্ষম হওয়া উচিত।
    • যদি আপনার কাজ 100% সম্পূর্ণ না হয়, তবে কী করা বাকি আছে তা পরিষ্কার হওয়া উচিত।

ভালো উদাহরণ

আপনাকে এই জিনিসগুলির সবগুলি (বা যে কোনও) করতে হবে না, তবে এইগুলি কিছু উপায় যা আপনি প্রয়োজনীয়তাগুলি পূরণ করতে পারেন৷

  • একটি ব্লগ পোস্ট বা ওয়েব পৃষ্ঠা বা সর্বজনীন GitHub সারাংশ তৈরি করুন যা আপনি যে কাজটি করেছেন তা বর্ণনা করে এবং আপনার করা প্রতিশ্রুতি এবং আপনি যে সংগ্রহস্থলগুলিতে কাজ করেছেন তার সাথে লিঙ্ক করে। যদি এখনও প্রকল্পে কাজ করা বাকি থাকে, তাও অন্তর্ভুক্ত করুন। আপনি হাইলাইট বা চ্যালেঞ্জিং টুকরা শেয়ার করতে পারেন.
    • ❗ এটি সর্বোত্তম বিকল্প কারণ এটি আপনাকে সহজেই প্রচুর তথ্য অন্তর্ভুক্ত করতে দেয়৷ এটি ভাল কারণ এটি স্পষ্টভাবে দেখাবে যে আপনি কী কাজ করেছেন, সেইসাথে এটি অন্যদের জন্য আপনার কোড ব্যবহার করা এবং বুঝতে সহজ করে।
  • যদি GitHub ব্যবহার করে, এবং আপনার সমস্ত কাজ একটি একক পুল অনুরোধ দ্বারা আচ্ছাদিত হয়, আপনি সেই লিঙ্কটি ব্যবহার করতে পারেন।
    • নিশ্চিত করুন যে পুল অনুরোধের বিবরণ বিস্তারিত আছে। (উপরে ব্লগ পোস্টের বিষয়বস্তুর জন্য পরামর্শ দেখুন।)
    • নিশ্চিত করুন যে বিবরণ স্পষ্টভাবে নোট করে যে এটি Google সামার অফ কোডের জন্য।
    • GSoC শেষ হওয়ার পরে যদি পুল অনুরোধে আরও কাজ করা হয়, তাহলে নিশ্চিত করুন যে শেষ GSoC প্রতিশ্রুতিটি উল্লেখ করা হয়েছে।
    • ❗ এই উদাহরণে পরিবর্তন লগ, প্রতিশ্রুতির একটি তালিকা এবং পর্যালোচনা মন্তব্যগুলি এক জায়গায় থাকার সুবিধা রয়েছে।
  • আপনার GitHub সংগ্রহস্থল যদি GSoC-এর জন্য একক উদ্দেশ্য হয়, তাহলে আরও বিস্তারিত সহ একটি README.md যোগ করুন।
  • সর্বজনীনভাবে সংরক্ষণাগারভুক্ত বিকাশকারী মেইলিং তালিকায় একটি ইমেল পাঠান, উপরেরটি সহ, এবং তার সাথেও লিঙ্ক করুন৷
  • Google ড্রাইভে একটি সর্বজনীন ফোল্ডার তৈরি করুন এবং আপনার তৈরি করা সমস্ত প্যাচ অন্তর্ভুক্ত করুন৷
  • Google পত্রক দিয়ে একটি সর্বজনীন স্প্রেডশীট তৈরি করুন এবং আপনার সমস্ত প্রতিশ্রুতি তালিকাভুক্ত করুন৷
  • একটি একক বাগের সাথে লিঙ্ক করুন যাতে স্পষ্টভাবে কাজের রেফারেন্স এবং অন্য কিছু উপযুক্ত। এটি আপনার করা সমস্ত কাজ ট্র্যাক করা উচিত। নিশ্চিত করুন যে এটি সমস্ত প্রতিশ্রুতি তালিকাভুক্ত করে বা অন্যথায় সেগুলি খুঁজে পাওয়া সহজ।
  • আপনার পরিবর্তনগুলির একটি ইউনিফাইড বা প্রসঙ্গের পার্থক্যের সাথে লিঙ্ক করুন৷ একটি শিরোনাম অন্তর্ভুক্ত করতে ভুলবেন না যা নোট করে যে এটি কোন প্রকল্পের জন্য এবং আপনি কার, তাই এটি অন্যদের জন্য দরকারী।

খারাপ উদাহরণ

এই কাজগুলো করবেন না।

  • পুরো প্রোজেক্টের সোর্স কোড বা আপনার কাজের ডিরেক্টরি ধারণকারী একটি টারবল/জিপফাইলের সাথে লিঙ্ক করুন। (অনেক লোক এটি অতীত করেছে, আপনি যা করেছেন সে সম্পর্কে আরও বুঝতে চান এমন লোকেদের পক্ষে এটি সহায়ক নয়।)
  • প্রকল্পের প্রাথমিক উৎস সংগ্রহস্থলের শীর্ষে লিঙ্ক করুন।
  • প্রজেক্টের সোর্স রিপোজিটরির আপনার ক্লোনের সাথে লিঙ্ক করুন।
    • এটি আপনার পরিবর্তনগুলি দেখতে কঠিন করে তোলে কারণ আপনার কাজ অন্যদের সাথে মিশ্রিত।
  • আপনার GSoC প্রকল্প পৃষ্ঠাতে লিঙ্ক করুন।
    • আমরা ইতিমধ্যে জানি যে কি. (যেমন https://summerofcode.withgoogle.com/projects/#1234567890 )

পরামর্শদাতা

অনুগ্রহ করে আপনার অবদানকারীকে একটি সঠিক কোড জমা দিতে সাহায্য করুন। চূড়ান্ত কাজ জমা দেওয়ার সময় আগে এটি করা গুরুত্বপূর্ণ।

যে পরীক্ষা…

  • জমা উপরের প্রয়োজনীয়তা পূরণ করে.
  • কোড কম্পাইল.
  • কি এবং কেন ডকুমেন্টেশন আছে.

GSoC-এর ধারণা এই নয় যে অবদানকারীরা কোড মন্থন করে -- এটা গুরুত্বপূর্ণ যে কোডটি হোস্টিং ওপেন সোর্স প্রকল্পের জন্য সম্ভাব্যভাবে উপযোগী।