ডক্স কেস স্টাডি উদাহরণের Google সিজন

বর্তমান পর্যায়:
ডকুমেন্টেশন উন্নয়ন. টাইমলাইন দেখুন।

আপনার নিজের কেস স্টাডি রিপোর্ট তৈরি করতে সাহায্য করার জন্য এই উদাহরণটি ব্যবহার করুন।

পিকলপ্লাস: গ্লোরিয়াস পিকল কন্ট্রিবিউশন টুলের ডকুমেন্টিং

অর্গানাইজেশন বা প্রজেক্ট: এখানে আপনার প্রতিষ্ঠান বা প্রোজেক্টের মূল সাইটের গ্লোরিয়াস পিকল লিঙ্ক

প্রতিষ্ঠানের বর্ণনা: গ্লোরিয়াস পিকল (বর্তমান সংস্করণ 1.2.3, 2009 সালে প্রথম প্রকাশ) হল একটি এমআইটি- লাইসেন্সপ্রাপ্ত লাইব্রেরি যা একটি একক নির্জন থেকে পরিমানে প্রতিটি সম্ভাব্য আচারযোগ্য সবজির জন্য লবণ, চিনি, ভিনেগার এবং মশলার নিখুঁত অনুপাত সহজেই গণনা করার জন্য। বাচ্চা শসা থেকে ধারক-শিপলোড মুলা।

লেখক: ঐচ্ছিক: কেস স্টাডির লেখকদের তালিকা; অনুরোধ করা হলে ব্যবহারকারীর নাম ব্যবহার করুন

সমস্যা বিবৃতি/প্রস্তাব বিমূর্ত

নতুন বা উন্নত ডকুমেন্টেশন দিয়ে আপনি কোন সমস্যা সমাধানের চেষ্টা করছেন? আপনার প্রকল্প সাইটে প্রস্তাব পৃষ্ঠা লিঙ্ক, যদি সম্ভব হয়.

GloriousPickle টুল উপাদান ডাটাবেসে উপাদান যোগ করা সময়সাপেক্ষ এবং জটিল, এবং টুলটির ভালো ডকুমেন্টেশন নেই। অনেক অবদানকারীর গিট ব্যবহার বা পুল অনুরোধ করার অভিজ্ঞতা নেই। এর মানে হল GloriousPickle-এর আমাদের উপাদান ডেটাতে গুরুতর ফাঁক রয়েছে এবং আমাদের টুলকে কম উপযোগী করে তোলে। নতুন উপাদান যোগ করার জন্য ডকুমেন্টেশন উন্নত করার মাধ্যমে, আমরা নতুন অবদানকারীদের এবং আরও পিকলিং উত্সাহিত করতে আশা করি!

প্রকল্প বর্ণনা

প্রস্তাব তৈরি করা

আপনি কীভাবে আপনার Google সিজন অফ ডক্স প্রস্তাব নিয়ে এসেছেন? একটি ধারণা সম্পর্কে সিদ্ধান্ত নিতে আপনার সংস্থা কোন প্রক্রিয়া ব্যবহার করেছিল? আপনি কিভাবে অনুরোধ করেছেন এবং প্রতিক্রিয়া অন্তর্ভুক্ত করেছেন?

GloriousPickle PickleDocs SIG গুগলের ওপেন সোর্স প্রোগ্রাম অফিস থেকে একটি টুইটের মাধ্যমে ডক্স প্রোগ্রামের গুগল সিজন সম্পর্কে শুনেছে। SIG তাদের পাক্ষিক বৈঠকে প্রোগ্রামটি নিয়ে আলোচনা করেছে, এবং একটি প্রস্তাব তৈরি করতে সম্মত হয়েছে। SIG-এর দুই সদস্য (@KimChiCook এবং @Dillicious) পরবর্তী সভায় পর্যালোচনার জন্য খসড়া প্রস্তাবে কাজ করতে স্বেচ্ছায় কাজ করেছেন।

একবার PickleDocs SIG প্রস্তাবের খসড়াতে সম্মত হলে, প্রতিক্রিয়া জানতে চেয়ে বিস্তৃত প্রকল্পে একটি ইমেল পাঠানো হয়েছিল। @GloriousPicklePat, উপাদান-সংযোজন API-এর রক্ষণাবেক্ষণকারী সহ চৌদ্দ জন সম্প্রদায়ের সদস্য প্রতিক্রিয়া দিয়েছেন। @GloriousPicklePat প্রোগ্রাম চলাকালীন একটি সম্পদ হতে স্বেচ্ছাসেবক।

প্রাপ্ত প্রতিক্রিয়া আলোচনা এবং অন্তর্ভুক্ত করার পরে, প্রস্তাবটি একটি ভোটের জন্য GloriousPickle প্রজেক্ট স্টিয়ারিং কমিটির কাছে পাঠানো হয়েছিল। GPPSC-এর পাঁচজন সদস্যই প্রস্তাব এবং আবেদন জমা দেওয়ার জন্য +1 ভোট দিয়েছেন এবং @VinegarViv প্রোগ্রামে অংশগ্রহণ ও অর্থপ্রদানের তত্ত্বাবধানের জন্য প্রয়োজনীয় ওপেন কালেকটিভ অ্যাকাউন্ট তৈরি করতে সাহায্য করতে সম্মত হয়েছে।

বাজেট

আপনার বাজেটে একটি সংক্ষিপ্ত বিভাগ অন্তর্ভুক্ত করুন। আপনি কিভাবে কাজ অনুমান? কোন অপ্রত্যাশিত খরচ ছিল? আপনি কি অনুদান পুরস্কারের চেয়ে কম খরচ করেছেন? আপনি কি সঠিকভাবে তহবিল বরাদ্দ করেছেন নাকি কিছু আইটেম আপনি বেশি/কম/অপ্রয়োজনীয় জন্য বাজেট করেছেন? ডক্সের Google সিজনের বাইরে আপনার কি অন্য ফান্ড ছিল যা আপনি ব্যবহার করতে পেরেছিলেন?

GloriousPickle PickleDocs SIG-এর দুই সদস্য প্রযুক্তিগত লেখক হিসেবে কাজ করেছেন (একজন ইউরোপে এবং একজন আর্জেন্টিনায়)। তারা আমাদের কাজ অনুমান করতে এবং অনুরূপ প্রকল্প বাজেট খুঁজে পেতে সাহায্য করেছে, তারা আগে করা খসড়া প্রস্তাবের কাজের তুলনা করে। আমাদের 2019 PicklePals কনভেনশন থেকে সীমাহীন স্পন্সরশিপের অর্থের জন্য US$1000 অবশিষ্ট ছিল যা আমরা প্রকল্পে বরাদ্দ করেছি।

একটি অপ্রত্যাশিত খরচ আমাদের প্রযুক্তিগত লেখককে একটি ওয়াই-ফাই হটস্পট ভাড়া নিতে সাহায্য করছে, কারণ তারা দাবানলে ক্ষতিগ্রস্ত এলাকায় ছিল এবং তাদের বাড়িতে ইন্টারনেট অ্যাক্সেস হারিয়েছে। আমরা আমাদের পরিকল্পনার তুলনায় অংশগ্রহণকারীদের কম টি-শার্ট পাঠাতেও শেষ করেছি, তাই এটি ভারসাম্যপূর্ণ।

উপরন্তু, আমরা একজন GloriousPickle অবদানকারীকে ক্ষতিপূরণ দেওয়ার সিদ্ধান্ত নিয়েছি, @Piccalily (যিনি একসময় তার অ-আচার জীবনে একজন পেশাদার কপিএডিটর ছিলেন) প্রযুক্তিগত লেখকের তৈরি ডকুমেন্টেশন কপিএডিটিং এবং প্রুফরিডিংয়ে সহায়তা করার জন্য।

অংশগ্রহণকারীরা

কে এই প্রকল্পে কাজ করেছে (অংশগ্রহণকারীদের দ্বারা অনুরোধ করা হলে ব্যবহারকারীর নাম ব্যবহার করুন)? আপনি কীভাবে আপনার প্রযুক্তিগত লেখককে খুঁজে পেয়েছেন এবং নিয়োগ করেছেন? আপনি কিভাবে অন্যান্য স্বেচ্ছাসেবক বা অর্থ প্রদানকারী অংশগ্রহণকারীদের খুঁজে পেয়েছেন? তাদের কি ভূমিকা ছিল? কেউ কি বাদ পড়েছে? নিয়োগ, যোগাযোগ এবং প্রকল্প ব্যবস্থাপনা সম্পর্কে আপনি কী শিখেছেন?

এই প্রকল্পে কাজ করা মূল দল ছিল:

  • @Dillicious, @KimChiCook (PickleDocs SIG)
  • @পিকালিলি (কপিডিটর)
  • @GherKen, @VinegarViv (প্রশাসন সহায়তা, GPPSC)
  • @BBChips, @GloriousPicklePat (বিষয়-বিষয় বিশেষজ্ঞ)
  • স্যাম স্ক্রাইব (প্রযুক্তিগত লেখক)

আমরা ডক্স গিটহাব রিপোজিটরি তালিকার গুগল সিজনের মাধ্যমে স্যাম স্ক্রাইবকে খুঁজে পেয়েছি। আমরা ভেবেছিলাম তাদের অভিজ্ঞতা (স্যাম একটি রন্ধনসম্পর্কীয় ম্যাগাজিনের জন্য কাজ করেছিল এবং সেইসাথে ওয়েবসাইটের জন্য ডকুমেন্টেশন লেখার জন্য) আমাদের প্রকল্পের সাথে ভাল মিলেছে। স্যাম PickleDocs SIG দ্বি-সাপ্তাহিক কলে যোগদান করেছেন এবং আমাদের সাথে প্রকল্পের মাধ্যমে কথা বলেছেন, বেশ কিছু মূল্যবান পরামর্শ দিয়েছেন যা আমরা প্রস্তাবটিতে অন্তর্ভুক্ত করেছি। আমরা আমাদের এসআইজি সদস্যদের নেটওয়ার্কগুলির মাধ্যমে আমাদের পরিচিত আরও দুইজন প্রযুক্তিগত লেখকের সাথে যোগাযোগ করেছি, কিন্তু প্রোগ্রামের সময়সীমার মধ্যে কেউই উপলব্ধ ছিল না।

যেহেতু স্যামের টাইম জোন PickleDocs SIG-এর বেশিরভাগ সদস্যের সাথে মাত্র কয়েক ঘন্টার জন্য ওভারল্যাপ করে, আমরা Picklersদের জন্য আমাদের আলোচনা ফোরামে একটি কল পাঠিয়েছিলাম যারা স্যামের টাইম জোনে ছিলেন এবং উপাদান-সংযোজন প্রক্রিয়ার সাথে পরিচিত। @BBChips স্বেচ্ছায় স্যামের প্রশ্নের উত্তর দিতে এবং প্রয়োজন অনুযায়ী অন্যান্য বিশেষজ্ঞদের খুঁজে পেতে তাদের সাহায্য করেছে। @GloriousPicklePat এছাড়াও স্যামকে টুলের অন্তর্নিহিত আর্কিটেকচার এবং API থেকে সম্ভাব্য ত্রুটির বার্তাগুলি বুঝতে সাহায্য করার জন্য স্বেচ্ছায় কাজ করেছে এবং GitHub এবং গিট সহায়তা প্রদান করেছে।

দুর্ভাগ্যবশত, প্রোগ্রামের মাঝপথে @ভিনেগারভিভকে ব্যক্তিগত কারণে প্রকল্প থেকে সরে আসতে হয়েছিল। GPPSC সদস্য @GherKen প্রশাসনিক এবং অর্থপ্রদানের প্রশ্নগুলি পরিচালনা করার জন্য এগিয়ে গেছেন।

কিছু মিস করা প্রশ্নের পরে (গ্লোরিয়াসপিকল একটি ফ্রি স্ল্যাক উদাহরণ ব্যবহার করে এবং মাঝে মাঝে আলোচনাটি এত দ্রুত চলে যায় যে রোলিং সংরক্ষণাগার সীমার কারণে আমরা কথোপকথন হারিয়ে ফেলি) আমরা শিখেছি যে আমাদের একটি শেয়ার করা ডকুমেন্টে চলমান প্রশ্নের একটি তালিকা রাখা উচিত (আমরা একটি শেয়ার্ড গুগল ব্যবহার করেছি ডক)। PickleDocs SIG সদস্যরা প্রতিটি সভার আগে এটি পরীক্ষা করে দেখেন এবং মিটিং শেষ হওয়ার আগে উত্তর পেতে নিশ্চিত হন। জরুরী প্রশ্নের জন্য স্যাম সরাসরি @BBChips কে পিং করতে সক্ষম হয়েছিল।

আমরা স্যাম এবং স্যামের সাথে কাজ করে খুব খুশি হয়েছিলাম, গ্লোরিয়াসপিকল ডকুমেন্টেশন আপডেট করার পাশাপাশি, তারা নিজেরাই একটি আগ্রহী পিকলার হয়ে উঠেছে!

টাইমলাইন

আপনার প্রকল্পের সময়রেখার একটি সংক্ষিপ্ত ওভারভিউ দিন (প্রকল্প চলমান থাকলে আনুমানিক শেষ তারিখ বা মধ্যবর্তী মাইলফলক নির্দেশ করুন)।

আমরা যখন Google সিজন অফ ডক্স প্রোগ্রামের অংশগ্রহণকারী সংস্থাগুলি ঘোষণা করার জন্য অপেক্ষা করছিলাম, তখন PickleDocs SIG সদস্যরা যে কোনও পূর্ববর্তী কাজের জন্য অনুসন্ধান করেছিলেন যা আমরা ভেবেছিলাম যে স্যামের জন্য উপযোগী হবে। এক মাসের মধ্যে, আমরা স্থগিত ডকুমেন্টেশন আপডেট করার পূর্বের প্রচেষ্টা থেকে কিছু নোট পেয়েছি, এবং আমরা Google opendocs repo- তে ডকুমেন্টেশন পরিপক্কতা নিরীক্ষা সামগ্রীর অংশগুলির মাধ্যমেও কাজ করেছি।

একবার আমরা সুসংবাদ পেয়েছিলাম যে আমরা ডক্সের Google সিজনের জন্য নির্বাচিত হয়েছি, স্যাম এবং পিকলডকস এসআইজি মিলিত হয়েছে এবং একটি মোটামুটি সময়সূচী তৈরি করেছে:

মঞ্চ দ্বারা সম্পন্ন
ডক্স অডিট পর্যালোচনা করুন 7 মে
ঘর্ষণ লগ 3 ব্যবহার ক্ষেত্রে 14 মে
@GloriousPicklePat এবং @BBChips-এর সাথে ঘর্ষণ লগগুলি পর্যালোচনা করুন, প্রশ্নের উত্তর দিন 28 মে
আপডেট হওয়া ডক্সের প্রথম খসড়া কেস 1 ব্যবহার করে 25 জুন
কেস 1 খসড়াটি @GloriousPicklePat এবং @KimChiCook দ্বারা পর্যালোচনা করা হয়েছে 2 জুলাই
আপডেট হওয়া ডক্সের প্রথম খসড়া কেস 2 ব্যবহার করে 2 জুলাই
@GloriousPicklePat এবং @Dillicious দ্বারা পর্যালোচনা করা কেস 2 খসড়া ব্যবহার করুন 9 জুলাই
আপডেট হওয়া ডক্সের প্রথম খসড়া কেস 3 ব্যবহার করে 9 জুলাই
@Dillicious এবং @KimChiCook দ্বারা পর্যালোচনা করা কেস 3 খসড়া ব্যবহার করুন 16 জুলাই
সমস্ত ব্যবহারের ক্ষেত্রে সমস্ত প্রশ্নের উত্তর দেওয়া হয়েছে 30 জুলাই
PickleDocs SIG-এর বেশিরভাগই 1-20 আগস্ট ছুটিতে ছিলেন --
সম্প্রদায়ে নতুন ডক্সের পরীক্ষা শুরু করুন (GloriousPickle সাইটে খসড়া হিসাবে প্রকাশিত নথি) 21 আগস্ট
পরীক্ষার প্রতিক্রিয়া অন্তর্ভুক্ত করা হয়েছে 10 সেপ্টেম্বর
নতুন ডক্সের কপিডিট এবং প্রুফরিড 17 সেপ্টেম্বর
ডক্সের খসড়া স্ট্যাটাস সরানো হয়েছে, ডক্স আনুষ্ঠানিকভাবে চালু হয়েছে 28 সেপ্টেম্বর
ডকুমেন্টেশন আপডেট করার প্রক্রিয়া তৈরি করা হয়েছে ১ নভেম্বর
এই কেস স্টাডি তৈরি 8 নভেম্বর
কেস স্টাডি জমা দেওয়া হয়েছে 16 নভেম্বর

আমাদের প্রস্তাবিত বাজেটে আমরা অনুমান করেছি যে প্রযুক্তিগত লেখক আমাদের প্রকল্পে প্রতি সপ্তাহে 10-15 ঘন্টা ব্যয় করবেন। স্যাম প্রতি সপ্তাহে 11.5 ঘন্টা ব্যয় করা সময়ের রেকর্ড রাখে।

ফলাফল

কি তৈরি, আপডেট, বা অন্যথায় পরিবর্তন করা হয়েছে? যদি পাওয়া যায় তবে প্রকাশিত ডকুমেন্টেশনের লিঙ্কগুলি অন্তর্ভুক্ত করুন। প্রস্তাবে কি কোনো ডেলিভারেবল ছিল যা তৈরি হয়নি? সেগুলিও তালিকাভুক্ত করুন।

তিনটি প্রধান ব্যবহারের ক্ষেত্রে সম্পূর্ণ ব্যবহারকারীর নির্দেশিকা সহ নথিভুক্ত করা হয়েছে:

GloriousPickle এ কিভাবে একটি নতুন উপাদান যোগ করবেন

GloriousPickle-এ কীভাবে একটি বৈকল্পিক উপাদান যুক্ত করবেন

গ্লোরিয়াস পিকলের একটি উপাদান কীভাবে আপডেট বা সংশোধন করবেন

এই নির্দেশিকাগুলিতে অবদানগুলিকে আরও সহজ করার জন্য নতুন পুল অনুরোধ টেমপ্লেটগুলি অন্তর্ভুক্ত রয়েছে৷

এছাড়াও, প্রকল্পের সময় স্যাম তাদের শিখে নেওয়া পদগুলির একটি ছোট পিকল শব্দকোষ তৈরি করেছিলেন, যা গ্লোরিয়াস পিকল প্রকল্প সাইটেও প্রকাশিত হয়েছিল।

আমরা আমাদের প্রজেক্ট উইকিতে এই ব্যবহারকারীদের কীভাবে-করতে হবে নির্দেশিকা আপডেট করার জন্য নির্দেশাবলী যোগ করেছি।

আমরা GitHub-এ নতুন অবদানকারীদের জন্য আমাদের প্রক্রিয়া এবং সরঞ্জামগুলি ব্যবহার করতে সাহায্য করার জন্য একটি চিট শীট তৈরি করা অন্তর্ভুক্ত করেছিলাম, কিন্তু একবার আমরা উপলব্ধ সংস্থানগুলির দিকে তাকাই আমরা পরিবর্তে অন্য প্রকল্পের চিট শীট কাঁটাতে সক্ষম হয়েছিলাম।

মেট্রিক্স

প্রকল্পের সাফল্য পরিমাপ করার জন্য আপনি কোন মেট্রিক্স বেছে নিয়েছেন? আপনি কি সেই মেট্রিক্স সংগ্রহ করতে পেরেছেন? আপনি প্রকল্পের জন্য যে ফলাফলগুলি চেয়েছিলেন তার সাথে মেট্রিক্সগুলি ভাল বা খারাপভাবে সম্পর্কযুক্ত ছিল? আপনার প্রস্তাবের পর থেকে আপনার মেট্রিক্স কি পরিবর্তিত হয়েছে?

আমাদের প্রস্তাবে, আমরা দুটি মেট্রিক্স প্রস্তাব করেছি:

  • উপাদান-সম্পর্কিত টান অনুরোধ সংখ্যা
  • নতুন অবদানকারীদের কাছ থেকে পুল অনুরোধের সংখ্যা

সেপ্টেম্বর মাসের জন্য (খসড়া ডকুমেন্টেশন প্রকাশের পর প্রথম পুরো মাস) আমরা উপাদান-সম্পর্কিত পুল অনুরোধে 5% বৃদ্ধি দেখেছি (আগস্টের 20 থেকে সেপ্টেম্বরে 21) এবং আমরা তিনজন নতুন অবদানকারীকে দেখেছি যারা মোট চারটি করেছেন পুল অনুরোধ (বনাম দুই নতুন অবদানকারী যারা আগস্টে দুটি পুল অনুরোধ করেছেন)। আমরা মাসিক এই মেট্রিক্স ট্র্যাক করার পরিকল্পনা.

1 জানুয়ারী থেকে শুরু করে, আমরা ডকুমেন্টেশন প্রকাশের পর ত্রৈমাসিক থেকে শুরু করে, সামগ্রিকভাবে তিনটির বেশি অবদানকারী অবদানকারীদের সংখ্যাও ট্র্যাক করব।

উপাখ্যানগতভাবে, আমরা বিশ্বাস করি যে এই নতুন ডকুমেন্টেশন নতুন অবদানকারীদের GloriousPickle উপাদান ডাটাবেসে যোগ করতে সক্ষম করার ক্ষেত্রে একটি পার্থক্য তৈরি করেছে—একজন নতুন অবদানকারী তাদের PR-এর মন্তব্যে উল্লেখ করেছেন যে তারা আগে চেষ্টা করেছিলেন কিন্তু তাদের আপডেট সম্পূর্ণ করেননি কারণ তারা তা করেননি। প্রক্রিয়া বুঝতে।

বিশ্লেষণ

কি ভাল হয়েছে? কি অপ্রত্যাশিত ছিল? আপনি কোন বাধা বা বিপত্তির সম্মুখীন হয়েছেন? আপনি কি আপনার প্রকল্প সফল বলে মনে করেন? কেন অথবা কেন নয়? (যদি বলা খুব তাড়াতাড়ি হয়, আপনি কখন আপনার প্রকল্পের সাফল্যের বিচার করতে সক্ষম হবেন তা ব্যাখ্যা করুন।)

আমরা আমাদের Google সিজন অফ ডক্স প্রকল্পের ফলাফলে অত্যন্ত সন্তুষ্ট এবং এটিকে সফল বলে মনে করি৷ নতুন ডকুমেন্টেশন স্পষ্ট এবং সহায়ক, এবং আমরা ইতিমধ্যে উপাদান-সম্পর্কিত পুল অনুরোধের সংখ্যা এবং নতুন অবদানকারীদের কাছ থেকে পুল অনুরোধের সংখ্যায় কিছু বৃদ্ধি দেখেছি।

আমরা এও খুশি যে প্রায় সমগ্র GloriousPickle সম্প্রদায় অংশ নিয়েছিল, মূল প্রস্তাবে মতামত দেওয়ার মাধ্যমে এবং খসড়া আকারে নতুন ডক্স পরীক্ষা করে।

আমরা কয়েকটি অপ্রত্যাশিত প্রতিবন্ধকতার মুখোমুখি হয়েছিলাম—আমরা কৃতজ্ঞ যে স্যামের রাজ্যে দাবানল ইন্টারনেট বিভ্রাটের চেয়ে বেশি ক্ষতি করেনি! এছাড়াও, প্রকল্প থেকে @VinegarViv হারানোর জন্য আমরা দুঃখিত ছিলাম; আমরা তাকে এবং তার পরিবারের মঙ্গল কামনা করি এবং শীঘ্রই তাকে আবার দেখতে পাব বলে আশা করি।

স্যাম ডকুমেন্টেশনে কাজ শুরু না করা পর্যন্ত একটি জিনিস আমরা বুঝতে পারিনি তা হল কতগুলি আচার-সম্পর্কিত পদ এবং সংক্ষিপ্ত শব্দগুলি আমাদের প্রকল্পে কোনও পিকলিং ব্যাকগ্রাউন্ড ছাড়াই আসা কারও কাছে অপরিচিত হবে। যাইহোক, স্যাম প্রতিটি অপরিচিত শব্দের একটি তালিকা রাখার একটি পয়েন্ট তৈরি করেছেন এবং তাদের নিজস্ব গবেষণার মাধ্যমে এবং সম্প্রদায়ের সদস্যদের ব্যাখ্যা এবং রেফারেন্সের জন্য জিজ্ঞাসা করে তাদের সংজ্ঞায়িত করেছেন। এই আচার শব্দকোষ ভবিষ্যতে পিকলিং সম্প্রদায়ে আরও বেশি লোককে স্বাগত জানাতে একটি বিশাল সহায়ক হবে।

সারসংক্ষেপ

2-4 অনুচ্ছেদে, আপনার প্রকল্পের অভিজ্ঞতা সংক্ষিপ্ত করুন। আপনি যা শিখেছেন তা হাইলাইট করুন এবং ভবিষ্যতে আপনি ভিন্নভাবে কি করতে বেছে নেবেন। ডকুমেন্টেশনের সাথে অনুরূপ সমস্যা সমাধানের চেষ্টা করা অন্যান্য প্রকল্পগুলিকে আপনি কী পরামর্শ দেবেন?

এক কথায়, আমাদের অভিজ্ঞতা ছিল পিকলেটস্টিক! আমরা আমাদের ডকুমেন্টেশন ডেলিভারেবল অর্জন করেছি এবং আমাদের মেট্রিক্স আমাদের লক্ষ্যের সাথে সঙ্গতিপূর্ণ বলে মনে হচ্ছে।

এই প্রকল্পের সাফল্যের একটি বিশাল অংশ ছিল আমাদের প্রযুক্তিগত লেখক, স্যাম স্ক্রাইবের সাথে কাজ করার ক্ষেত্রে আমরা কতটা ভাগ্যবান। [আমি এটি লিখিনি—স্যাম] যদিও গিটহাবের সাথে পিকিং বা অভিজ্ঞতার কোনো পটভূমি ছিল না, একজন অভিজ্ঞ প্রযুক্তিগত লেখক হিসাবে, তারা একটি নতুন বিষয়ের ক্ষেত্রে, প্রশ্ন জিজ্ঞাসা করতে এবং গবেষণা করতে স্বাচ্ছন্দ্যবোধ করেছিল। স্যাম দ্রুত শুধু আমাদের প্রজেক্ট টুলসই নয় (আমরা কাজের ট্র্যাক রাখতে একটি কানবান বোর্ড ব্যবহার করি) কিন্তু আমাদের আচার-জোকসও তুলে নিল! আমরা খুব খুশি যে স্যাম পিকলিং বাগটি ধরেছে এবং আমরা সেগুলিকে আমাদের সম্প্রদায়ে 'বোতল' করেছি৷

আমরা অন্যান্য প্রকল্পগুলিকে পরামর্শ দেব:

  • আপনার প্রস্তাবগুলি ছোট এবং পরিচালনাযোগ্য রাখুন। (আমরা মূলত আমাদের প্রস্তাবে শিল্প ব্যাচ পিকলিং মেশিনারির সাথে আমাদের অনুমানকারী ব্যবহার করার জন্য ডকুমেন্টেশন অন্তর্ভুক্ত করতে চেয়েছিলাম, এবং শুধুমাত্র এটি বাদ দিয়েছিলাম কারণ আমাদের সম্প্রদায়ের একজন সদস্য গভীরভাবে ওপেন-সোর্সিং পিকেল মেশিনারির সাথে জড়িত ছিলেন প্রোগ্রাম চলাকালীন তার পিএইচডি থিসিস লিখতে চলেছেন .) আমরা স্যামকে ব্যস্ত রাখার জন্য পর্যাপ্ত কাজের চেয়ে বেশি কাজ করেছি!
  • একটি প্রযুক্তিগত লেখক খুঁজছেন যখন আপনার নেটওয়ার্ক লিভারেজ. আপনার সম্প্রদায়ের প্রত্যেককে সুপারিশের জন্য জিজ্ঞাসা করুন। যদিও আমরা ডক্স গিটহাবের Google সিজনের মাধ্যমে স্যামকে খুঁজে পেয়েছি, আমরা তাদের সাথে কাজ করতে আত্মবিশ্বাসী বোধ করেছি কারণ আমরা আবেদনের সময়কালে বেশ কয়েকজনের সাথে কথা বলেছি।
  • আপনার সম্প্রদায়ে আপনার প্রযুক্তিগত লেখককে স্বাগতম! স্যাম আমাদের জানান যে GloriousPicklers এর উত্সাহী মনোভাব প্রশ্ন জিজ্ঞাসা করা সহজ করেছে।
  • আপনার প্রযুক্তিগত লেখককে ওপেন সোর্স দক্ষতা পেতে সাহায্য করুন। স্যাম আগে কখনও গিট ব্যবহার করেনি, তবে কয়েকটি টিউটোরিয়ালের মধ্য দিয়ে যাওয়ার পরে তারা দ্রুত গতিতে উঠেছিল। প্রথমে স্যাম উদ্বিগ্ন ছিল যে তারা সম্প্রদায়ের কাছ থেকে কতটা প্রতিক্রিয়া পেতে পারে এবং কীভাবে এটিকে অন্তর্ভুক্ত করতে পারে, কিন্তু আমাদের সম্প্রদায়ের 'মোটামুটি ঐক্যমত্য' মডেল ( 'ঐকমত্য অর্জিত হয় যখন সমস্ত সমস্যা সমাধান করা হয়, কিন্তু অগত্যা স্থান দেওয়া হয় না' ) স্যামকে আত্মবিশ্বাসী করে তোলে তাদের প্রযুক্তিগত লেখার দক্ষতা ব্যবহার করে সমালোচনা মোকাবেলা করা।

পরিশিষ্ট

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

স্বীকৃতি

আমাদের দল নিম্নলিখিত ব্যক্তি এবং জিনিসগুলি স্বীকার করতে চাই:

  • @ডিলিসিয়াস তার সঙ্গী এবং লো-ফাই হিপ হপ রেডিওকে ধন্যবাদ জানাতে চাই
  • @KimChiCook তার 할머니 তাকে কীভাবে আচার করতে হয় তা শেখানোর জন্য তাকে ধন্যবাদ জানাতে চাই
  • @Piccalily অনলাইনের শিকাগো ম্যানুয়াল অফ স্টাইলকে ধন্যবাদ জানাতে চাই
  • @GherKen তার তিনটি বাচ্চাকে ধন্যবাদ জানাতে চাই তার তৈরি করা সমস্ত আচার খাওয়ার জন্য
  • @ভিনেগারভিভ তার পদত্যাগ করার জন্য দলের বাকি সদস্যদের ধন্যবাদ জানাতে চাই
  • @BBChips উপলব্ধ সেরা নন-আচার খাবারকে ধন্যবাদ জানাতে চাই, Tunnock's Caramel Wafers
  • @GloriousPicklePat এই প্রকল্পটি নেওয়ার জন্য PickleDocs SIG কে ধন্যবাদ জানাতে চাই
  • স্যাম স্ক্রাইব সমগ্র গ্লোরিয়াস পিকল সম্প্রদায়কে ধন্যবাদ জানাতে চাই, তবে বিশেষ করে পিকলারদের যারা 2021 সালের গ্রীষ্মের জার অভাবের সময় তাদের ক্যানিং জার পাঠিয়েছিলেন, অনেক সুস্বাদু আচারের পথে তাদের শুরু করেছিলেন!