2021 কেস স্টাডি রিপোর্ট

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

দ্রষ্টব্য: এই প্রতিবেদনটি মূল প্রোগ্রাম অ্যাপ্লিকেশন এবং সংস্থাগুলির চূড়ান্ত কেস স্টাডি থেকে ডেটা সংক্ষিপ্ত করে৷ সম্পূর্ণ কেস স্টাডিগুলি ডক্স ফলাফলের পৃষ্ঠার 2021 সিজন থেকে লিঙ্ক করা হয়েছে৷

ডক্সের মরসুম সম্পর্কে

ডক্সের সিজন হল Google ওপেন সোর্স প্রোগ্রাম অফিস দ্বারা পরিচালিত একটি টেকসই প্রোগ্রাম। ডক্সের মরসুমের লক্ষ্যগুলি হল:

  • ডকুমেন্টেশন সহ প্রকল্প সমস্যা সমাধানের জন্য ওপেন সোর্স প্রকল্পগুলির জন্য সমর্থন প্রদান করুন
  • প্রযুক্তিগত লেখকদের ওপেন সোর্সে অভিজ্ঞতা অর্জনের সুযোগ দিন
  • ওপেন সোর্স, ডকুমেন্টেশন এবং প্রযুক্তিগত লেখার বিষয়ে সচেতনতা বাড়ান
  • ওপেন সোর্স ডকুমেন্টেশনে কার্যকর মেট্রিক্স সম্পর্কে তথ্য সংগ্রহ এবং শেয়ার করুন

ডক্সের মরসুম সম্পর্কে আরও তথ্য প্রোগ্রামের ওয়েবসাইটে উপলব্ধ।

2021 প্রোগ্রাম ওভারভিউ

2021 প্রোগ্রাম পরিবর্তন

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

2021 সালে, সিজন অফ ডক্স টিম প্রোগ্রামে উল্লেখযোগ্য পরিবর্তন করেছে, ডকুমেন্টেশন ফলাফল পরিমাপের দিকে ফোকাস স্থানান্তরিত করেছে এবং সংস্থা এবং প্রযুক্তিগত লেখকদের জন্য আরও নমনীয়তার অনুমতি দিয়েছে।

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

2021 সাধারণ ফলাফল

সংস্থাগুলি

  • 2021 প্রোগ্রামের পরিবর্তনের ফলে কম সংস্থা আবেদন করেছে (আমরা 2021 বনাম 2020 সালে 30% কম সংস্থা আবেদন করতে দেখেছি) কিন্তু 2021 সংস্থার প্রশাসকরা 2020 অ্যাডমিনদের তুলনায় (93% v 91%) প্রোগ্রামে কিছুটা বেশি সন্তুষ্ট ছিলেন।

সমস্যা, ডকটাইপ এবং মেট্রিক্স

  • বেশিরভাগ প্রকল্প রক্ষণাবেক্ষণকারীর বোঝা কমানোর জন্য ডকুমেন্টেশন তৈরির উপর দৃষ্টি নিবদ্ধ করে (ইস্যু/প্রশ্ন কমানোর মাধ্যমে) এবং/অথবা প্রকল্পের অংশগ্রহণ বৃদ্ধি করে (হয় প্রকল্প ব্যবহারকারী বা অবদানকারীদের দ্বারা)।
    • 50% স্বীকৃত প্রতিষ্ঠান টিউটোরিয়াল বা হাউ-টু কন্টেন্ট তৈরি করেছে।
    • 50% এরও বেশি স্বীকৃত সংস্থা তাদের বর্তমান ডকুমেন্টেশনের অভাব, অসংগঠিত বা পুরানো বলে মনে করেছে।
  • প্রকল্পগুলি সাধারণত ইন্টারঅ্যাকশনের মাধ্যমে তাদের ডকুমেন্টেশন কার্যকারিতা পরিমাপ করতে চায়, বিশেষত কম সমস্যা উত্থাপিত এবং ডক্সে বেশি দর্শক এবং প্রকল্পগুলিতে অংশগ্রহণ।
  • 2022 সালের নভেম্বর পর্যন্ত, 30টি প্রকল্পের মধ্যে 25টি সাড়া দিচ্ছে:
    • 18টি প্রকল্প বলেছে যে তারা তাদের মূল মেট্রিক্স পূরণ করেছে
    • 5টি প্রকল্প সংশোধিত মেট্রিক্স পূরণ করেছে
    • 2টি প্রকল্প বলেছে যে এটি বলার জন্য এখনও খুব তাড়াতাড়ি ছিল

প্রোগ্রামে অংশগ্রহণ

  • প্রযুক্তিগত লেখকদের নিয়োগ, নিয়োগ এবং অর্থ প্রদান সংস্থা প্রশাসকদের জন্য প্রোগ্রামের সবচেয়ে কঠিন অংশ ছিল।
  • 2022 সালের নভেম্বর পর্যন্ত, 30টি প্রতিষ্ঠানের মধ্যে 24টি সাড়া দিয়েছে:
    • 18টি সংস্থা এখনও তাদের সিজন অফ ডক্স প্রযুক্তিগত লেখকদের সাথে কাজ করছে (হয় একটি অব্যাহত অবদানকারী বা প্রশ্নের উত্তর দেওয়ার জন্য একটি সংস্থান হিসাবে)
      • 4টি সংস্থা তাদের সিজন অফ ডক্স প্রযুক্তিগত লেখকদের সাথে একটি অর্থ প্রদানের ভূমিকায় কাজ করছিল৷

2021 হাইলাইট

  • একাধিক প্রকল্প ইঙ্গিত দিয়েছে যে তাদের প্রযুক্তিগত লেখক ডক্স প্রোগ্রামের সিজন শেষ হওয়ার পরে তাদের প্রকল্পের সাথে কাজ চালিয়ে যাওয়ার ইচ্ছা পোষণ করেছেন
  • Metanorma-তে এত বেশি যোগ্য প্রযুক্তিগত লেখকরা আবেদন করেছিলেন যে তারা প্রোগ্রাম চলাকালীন ডক্স-সমর্থিত লেখকের সিজনের সাথে কাজ করার জন্য একজন অতিরিক্ত লেখক নিয়োগের জন্য মিলিত তহবিল খুঁজে পেয়েছেন
  • মোজা গ্লোবাল দেখেছে যে সম্প্রদায়টি ডকুমেন্টেশনের সাথে খুব নিযুক্ত ছিল এবং একটি নতুন ডকুমেন্টেশন ওয়ার্কিং গ্রুপ তৈরি করেছে যাতে আরও বেশি অবদানকারীদের প্রকল্পের ডকুমেন্টেশনে অংশগ্রহণ করার অনুমতি দেওয়া হয়।

2021 সারাংশ ডেটা

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

সংগঠন সম্পর্কে

ডক্স 2021-এর সিজনে অংশগ্রহণকারী সংস্থাগুলি ওপেন সোর্স প্রকল্পের বিভিন্ন পরিসরের প্রতিনিধিত্ব করেছে। 2021 কোহর্ট অন্তর্ভুক্ত:

  • বড় ভাষা প্রকল্প যেমন জুলিয়া , পার্ল এবং আর
  • শিক্ষা, জলবায়ু, ফিনটেক, স্বাস্থ্যসেবা, লাইব্রেরি পরিষেবা, মেশিন লার্নিং, গণ স্পেকট্রোমেট্রি, পাবলিক চুক্তি এবং রোবোটিক্সের প্রকল্পগুলি
  • বিশৃঙ্খল প্রকৌশল সরঞ্জাম, fuzzers, চ্যাটবট SDK, সফ্টওয়্যার রচনা বিশ্লেষণ পাইপলাইন, কর্মক্ষমতা পর্যবেক্ষণ সরঞ্জাম, এবং ভিজ্যুয়াল প্রোগ্রামিং সরঞ্জাম সহ বিকাশকারী-কেন্দ্রিক প্রকল্পগুলি
  • ডকুমেন্টেশন টুলের জন্য ডকুমেন্টেশন প্রকল্প, যেমন Redocly এবং Metanorma

পাইথন ইকোসিস্টেম প্রকল্পগুলি ছিল বৃহত্তম উপশ্রেণী। 2021 কোহর্টের মধ্যে রয়েছে ArviZ, NumPy, MicroPython, PyMC3, PyTorch-Ignite, এবং SymPy।

আমরা প্রকল্পগুলি সম্পর্কে কোনও মেটাডেটা সংগ্রহ করিনি (যেমন প্রতিষ্ঠার তারিখ, অবদানকারীদের ভৌগলিক বিতরণ, অবদানকারীদের সংখ্যা, বা ব্যবহারকারীর ভিত্তির আকার)।

আমরা কোন ওপেন সোর্স লাইসেন্স ব্যবহার করেছে তা নির্দেশ করতে প্রকল্পগুলিকে বলেছি।

A bar graph showing the number of projects using each OSS license: Apache 2.0: ten programs; 3-clause BSD: five programs; MIT: five programs; GPL 2.0: 4 programs; LGPL 2.1: 4 programs; Mozilla Public license 2.0: 3 programs; Artistic, Boost, and 2-clause BSD: one program each

2021 সংস্থাগুলির দ্বারা বর্ণিত ডকুমেন্টেশন সমস্যাগুলি ওপেন সোর্স প্রকল্প এবং সাধারণভাবে প্রযুক্তিগত ডকুমেন্টেশন উভয় ক্ষেত্রেই খুব সাধারণ সমস্যা।

2021 প্রোগ্রামে সংস্থাগুলি যে শীর্ষ সমস্যাগুলি সমাধান করার আশা করেছিল তার মধ্যে রয়েছে:

A bar graph showing the problems reported by organizations: Documentation is lacking for specific use cases of aspects of a project: 14 projects; Documentation is disorganized: 14 projects; Documentation is outdated: 6 projects; Documentation is not consistent: 3 projects; Documentation needs to be converted to a different tool, platform, or format: 2 projects

মনে রাখবেন যে সংস্থাগুলি একাধিক ডকুমেন্টেশন সমস্যা রিপোর্ট করতে পারে। আরও সুনির্দিষ্ট তথ্যের জন্য, সিজন অফ ডক্স 2021 ফলাফল পৃষ্ঠা দেখুন, যা প্রতিটি সংস্থার জন্য সম্পূর্ণ কেস স্টাডির সাথে লিঙ্ক করে।

ডকুমেন্টেশনের প্রকার তৈরি করা হয়েছে

2021 কেস স্টাডিতে টিউটোরিয়ালগুলি ছিল সবচেয়ে বেশি উল্লেখ করা ডকুমেন্টেশনের ধরন।

A bar graph showing the documentation types created: Tutorials: 9 projects; How-tos: 6 projects; Getting Started: 3 projects; Examples: 3 projects; Reference: 3 projects; API Docs, Video, Quickstart, Templates, Landing page: 2 projects each

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

এর মধ্যে কয়েকটি বিভাগ অস্পষ্ট এবং একটি একক ডকুমেন্টেশন প্রকল্পে একাধিক ডকুমেন্টেশন প্রকার বা বৈশিষ্ট্য থাকতে পারে।

বেশ কয়েকটি প্রকল্প বিশেষভাবে তাদের ডকুমেন্টেশন ধরনের পরিকল্পনা করার জন্য একটি নির্দেশিকা হিসাবে ডায়াট্যাক্সিস ফ্রেমওয়ার্ক ব্যবহার করে উল্লেখ করা হয়েছে।

আরও সুনির্দিষ্ট তথ্যের জন্য, সিজন অফ ডক্স 2021 ফলাফল পৃষ্ঠা দেখুন, যা প্রতিটি সংস্থার জন্য সম্পূর্ণ কেস স্টাডির সাথে লিঙ্ক করে।

বাজেট

2021 সালে, গড় বাজেট অনুরোধ ছিল $10,200 এবং মধ্যমা ছিল $10,000। শুধুমাত্র তিনটি সংস্থা অনুরোধ করেছে এবং সর্বাধিক সম্ভাব্য অনুদান ($15k) পেয়েছে এবং অন্য তিনটি সর্বনিম্ন সম্ভাব্য অনুদান ($5k) অনুরোধ করেছে৷

মেট্রিক্স

তাদের ক্ষেত্রে বর্ণিত প্রকল্পগুলি তাদের ডকুমেন্টেশন প্রকল্পগুলির সাফল্যের পরিমাপ করতে তারা যে মেট্রিকগুলি ব্যবহার করেছিল তা অধ্যয়ন করে।

শীর্ষ প্রস্তাবিত মেট্রিক্স ছিল:

A bar graph showing documentation success metrics: Fewer project issues/questions: 13 projects;  More visitors to documentation/docs usage: 9 projects; More contributors/pull requests: 8 projects; More documentation pull requests/contributions: 7 projects; Total number of docs created: 5 projects; Increased documentation satisfaction (via survey), Increased project use, More direct feedback on documentation pages: four projects each; Better SEO: three projects; Total percentation of documentation converted and Total percentage of target info covered by docs: two projects each

অন্যান্য প্রস্তাবিত মেট্রিক্সের মধ্যে রয়েছে গিটহাব তারকা, পৃষ্ঠায় ব্যয় করা সময়, মেলিং তালিকার রূপান্তর, গুণগত ব্যবহারকারীর পরীক্ষা, ফোরামে অংশগ্রহণকারীদের সংখ্যা, অংশীদার/স্বেচ্ছাসেবক/একীকরণের সংখ্যা।

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

আরও সুনির্দিষ্ট তথ্যের জন্য, সিজন অফ ডক্স 2021 ফলাফল পৃষ্ঠা দেখুন, যা প্রতিটি সংস্থার জন্য সম্পূর্ণ কেস স্টাডির সাথে লিঙ্ক করে।

প্রযুক্তিগত লেখকদের সাথে কাজ করা

2021 সালে ডক্স প্রোগ্রামের সিজনে সবচেয়ে বড় পরিবর্তনটি প্রযুক্তিগত লেখকদের সাথে প্রকল্পগুলি কীভাবে কাজ করে তা জড়িত। পূর্ববর্তী মরসুমে, প্রযুক্তিগত লেখকরা সরাসরি Google-এ আবেদন করেছিলেন এবং প্রোগ্রাম অ্যাডমিনিস্ট্রেটরদের দ্বারা প্রকল্পগুলির সাথে মিলিত হয়েছিল এবং Google থেকে সরাসরি একটি ফ্ল্যাট উপবৃত্তি প্রদান করা হয়েছিল।

2021 সালে, প্রযুক্তিগত লেখকরা সরাসরি প্রকল্পগুলিতে আবেদন করেছিলেন এবং প্রকল্পগুলি ডক্স ওপেন কালেক্টিভ ফান্ডের সিজনের মাধ্যমে অর্থপ্রদান সহ প্রযুক্তিগত লেখক ক্ষতিপূরণের জন্য বাজেট নির্ধারণ করে।

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

নিয়োগের সুপারিশ

প্রকল্পগুলিকে ডক্সের সিজনে অংশগ্রহণ করতে আগ্রহী অন্যান্য প্রকল্পগুলির জন্য সুপারিশ করতে বলা হয়েছিল৷ শীর্ষ নিয়োগের সুপারিশ ছিল:

  • যত তাড়াতাড়ি সম্ভব প্রযুক্তিগত লেখকদের নিয়োগের উপকরণ ভাগ করুন, এমনকি আপনি প্রোগ্রামে গৃহীত হওয়ার আগেই। আপনার সম্প্রদায়কে সম্ভাব্য প্রার্থীদের উল্লেখ করতে বলুন।
  • প্রকল্প চ্যানেলের বাইরে ব্যাপকভাবে ভাগ করুন. অন্তর্ভুক্তিমূলক ভাষা ব্যবহার করুন এবং সরাসরি আবেদন করতে অনুপ্রাণিত ব্যাকগ্রাউন্ডের প্রার্থীদের উৎসাহিত করুন।
  • আপনার ডকুমেন্টেশন তৈরির প্রক্রিয়ার জন্য কোন সরঞ্জামগুলি অপরিহার্য তা বুঝুন এবং সেই সরঞ্জামগুলি ব্যবহার করার অভিজ্ঞতা সহ প্রযুক্তিগত লেখকদের নিয়োগ করুন৷
  • ডেলিভারেবল এবং মাইলস্টোন, যোগাযোগের চ্যানেল এবং চেক-ইন, এবং অর্থপ্রদানের প্রক্রিয়া এবং সময় সম্পর্কে প্রযুক্তিগত লেখকের জন্য স্পষ্ট প্রত্যাশা তৈরি করুন।
  • মেন্টরশিপ এবং কোচিং প্রদানের জন্য সিজন অফ ডক্স টেকনিক্যাল রাইটার ব্যবহার করে সম্প্রদায়ের সদস্যদের বিনিয়োগ করা এবং প্রযুক্তিগত লেখক হিসাবে তাদের বেড়ে উঠতে সহায়তা করার কথা বিবেচনা করুন।
  • কারিগরি লেখকদের অনবোর্ডিং এবং প্রশ্নের উত্তর দেওয়ার জন্য এবং প্রোগ্রাম চলাকালীন সহায়তা প্রদানের জন্য আপনার প্রত্যাশার চেয়ে বেশি সময় বাজেট করুন, বিশেষ করে যদি প্রযুক্তিগত লেখকের আপনার প্রকল্পের ডোমেনে পূর্ব অভিজ্ঞতা না থাকে।
  • ভবিষ্যতের প্রকল্পগুলির জন্য ব্যবহার করার জন্য আপনার নিয়োগ, নিয়োগ এবং অনবোর্ডিং প্রক্রিয়া নথিভুক্ত করুন।

A bar graph showing the source of technical writer candidates: Applied directly to program: 7; SoD GitHub or previous SoD participant: 4; Write the Docs Slack or Community member: 3 each; Applied via jobs site (Upwork, LinkedIn) or Google Summer of Code or Code-In alumni: 2 each

(দ্রষ্টব্য: সমস্ত প্রকল্প তাদের কেস স্টাডিতে নির্দেশিত নয় যেখানে তারা তাদের প্রযুক্তিগত লেখক প্রার্থীদের নিয়োগ করেছে।)

প্রযুক্তিগত লেখকদের সাথে কাজ করার ক্ষেত্রে সাধারণ সমস্যা

A bar graph showing technical writer issues: TW dropping out: 8 projects; Communications issues: 6 projects; TW onboarding: 4 projects; TW recruitment; Hiring or payment; Project tooling setup: 3 projects each

কোভিড বা অন্যান্য অসুস্থতার কারণে বা মহামারী সম্পর্কিত পারিবারিক দায়িত্বের কারণে বেশ কয়েকটি প্রকল্পের প্রযুক্তিগত লেখকদের বাদ পড়তে হয়েছিল। কিছু প্রকল্প টাইমজোন অমিল বা ইন্টারনেট সংযোগ সমস্যা জড়িত যোগাযোগ সমস্যা রিপোর্ট.

প্রকল্পগুলি দেখেছে যে তারা তাদের সম্প্রদায়গুলিতে অনবোর্ডিং বা তাদের প্রকল্পের ডক্স টুলচেন সেট আপ করার ক্ষেত্রে জড়িত অসুবিধাগুলিকে অবমূল্যায়ন করেছে৷

কিছু প্রকল্পে তাদের প্রযুক্তিগত লেখকদের অর্থ প্রদানে বিলম্ব হয়েছে কারণ ওপেন কালেক্টিভের সাথে ব্যাংকিং সমস্যার কারণে বা লেখকদের নিজ দেশে অর্থপ্রদানের সীমাবদ্ধতা ছিল।

ওপেন কালেক্টিভ ফি সম্পর্কে প্রোগ্রামের ডকুমেন্টেশন স্পষ্ট ছিল না: গুগল প্রকল্পে তহবিলের প্রাথমিক স্থানান্তরের জন্য ওপেন কালেক্টিভ লেনদেন ফি কভার করে, কিন্তু অন্য কিছু পেমেন্ট চ্যানেল (যেমন কারেন্সি কনভার্সন ফি) দ্বারা আরোপিত লেনদেন ফি নয়। আমরা ভবিষ্যতের প্রোগ্রামগুলির জন্য ডকুমেন্টেশনে এটি পরিষ্কার করার জন্য কাজ করব।

ফলোআপ সমীক্ষা

সিজন অফ ডক্স প্রোগ্রামের অংশ হিসাবে, প্রকল্পগুলিকে ফলোআপ সমীক্ষায় অংশগ্রহণ করতে বলা হয়েছিল৷ 2022 সালের মে, আগস্ট এবং নভেম্বরে তিনটি সমীক্ষা পাঠানো হয়েছিল।

A bar graph showing the number responses to the followup survey: May survey: 13 responses; August survey: 21 responses; November survey: 12 responses

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

  1. আপনি কি এখনও আপনার ডক্স প্রযুক্তিগত লেখকের সিজনের সাথে কাজ করছেন?

A bar graph showing ongoing participation by technical writers, per survey: in May, 6 projects had technical writers either participating or answering questions; 1 project had no ongoing technical writer involvement. In August, 11 projects had ongoing technical writer participation; seven projects had no ongoing technical writer participation, and 3 projects had technical writers answering questions. In November, 5 projects reported ongoing technical writer involvement; 3 projects reported no ongoing technical writer involvement; and 4 projects reported technical writers answering questions.

  1. যদি আপনার প্রযুক্তিগত লেখক এখনও আপনার প্রকল্পের সাথে কাজ করে থাকেন, তাহলে তাদের কি কোনোভাবে ক্ষতিপূরণ দেওয়া হচ্ছে?

A bar graph showing the number of projects reporting their project compensation for technical writers in each survey. In May, 5 projects reported their technical writers were being paid for ongoing work; 4 projects reported their technical writer was unpaid. In August, 4 projects reported paying their technical writer and 7 projects reported their technical writer was unpaid. In November, two projects reported paying their technical writer, and 5 projects reported their technical writer was unpaid.

  1. এই মুহুর্তে, আপনি কি আপনার ডকুমেন্টেশন প্রকল্প সফল বলে মনে করেন?

A bar graph showing the number of projects reporting success against metrics in each survey. In May, 6 projects reported their metrics had been met; 6 projects said it was too soon to tell, and 2 projects had met adjusted metrics. In August, 16 projects reported that metrics had been met; 3 projects reported adjusted metrics had been met; and 2 projects reported it was too soon to tell. In November, 9 projects reported metrics had been met; 3 projects reported adjusted metrics had been met, and no projects reported that it was still too soon to tell.

ভবিষ্যতের প্রশ্ন

বরাবরের মতো, ওপেন সোর্সে ডকুমেন্টেশন সম্পর্কে আমরা যত বেশি শিখি, ততই আমরা শিখতে চাই! ভবিষ্যতের মরসুমে, আমরা শিখতে আশা করি:

  • প্রজেক্ট ডোমেন ডকটাইপ পছন্দ বা মেট্রিক পছন্দের সাথে সম্পর্কযুক্ত কিনা
  • কোন প্রযুক্তিগত লেখক নিয়োগ এবং অনবোর্ডিং অনুশীলন প্রকল্প সমাপ্তি এবং প্রযুক্তিগত লেখক ধরে রাখার জন্য সবচেয়ে কার্যকর
  • ডকুমেন্টেশন কার্যকারিতা পরিমাপের জন্য যুক্তিসঙ্গত সময়রেখা

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