৪.৬ নথিপত্র ও জ্ঞান মেট্রিক

সারসংক্ষেপ এবং প্রেরণা

এই বিষয়টি পর্ব ৪ বন্ধ করে একটি কোডবেস নিরাপদে রক্ষণাবেক্ষণ করতে প্রয়োজনীয় জ্ঞান প্রকৃতপক্ষে নথিভুক্ত ও খুঁজে পাওয়া যায় কিনা তা পরিমাপ করে, শুধু নথিপত্র প্রযুক্তিগতভাবে কোথাও বিদ্যমান কিনা তা নয়। বিষয় ৩.৫ একটি ডেভেলপার-অভিজ্ঞতা উদ্বেগ হিসেবে যোগাযোগ ও সহযোগিতা আচ্ছাদন করেছে; এই বিষয় কোড পক্ষ থেকে একই অন্তর্নিহিত সমস্যা, জ্ঞান উপলব্ধতা, আচ্ছাদন করে: একজন নতুন প্রকৌশলী, বা একজন বিদ্যমান প্রকৌশলী অপরিচিত কোডে কাজ করছেন, তাদের একটি নিরাপদ পরিবর্তন করতে প্রয়োজনীয় যা আছে, নাকি সেই জ্ঞান শুধু সংকুচিত সংখ্যক মেয়াদপ্রাপ্ত মানুষদের মাথায় বাস করে।

এখানে পরিমাপ চ্যালেঞ্জ প্রকৃতপক্ষে কঠিন, এই বইয়ের বেশিরভাগ অন্য মেট্রিকের চেয়ে কঠিনতর, কারণ নথিপত্রের গুণমান ও উপযোগিতা একটি কভারেজ শতাংশ বা একটি জটিলতা স্কোরের চেয়ে সহজাতভাবে বেশি বিষয়ীগত। এই বিষয়ের পদ্ধতি হলো অস্তিত্বের বদলে উপযোগিতার জন্য প্রক্সি পরিমাপ করা: নথিপত্র কত ঘন ঘন প্রকৃতপক্ষে প্রবেশ করা হয়, একটি নথিভুক্ত উত্তর বিদ্যমান থাকা সত্ত্বেও একই প্রশ্ন কত ঘন ঘন বারবার জিজ্ঞাসা করা হয়, এবং একটি সিস্টেমে অপরিচিত কারো উৎপাদনশীল হতে কত সময় লাগে। এই প্রক্সিগুলোর কোনোটিই একা নিখুঁত নয়, কিন্তু একসাথে তারা একটি কোডবেস কত উইকি পৃষ্ঠা বা README ফাইল ধারণ করে তা গণনা করার চেয়ে অনেক বেশি সৎ চিত্র দেয়।

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

মূল নীতিসমূহ

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

সুপারিশসমূহ

শুধু অস্তিত্ব নয়, নথিপত্র প্রবেশ ও পুরনোত্ব ট্র্যাক করুন

যেখানে আপনার নথিপত্র প্ল্যাটফর্ম এটি সমর্থন করে, ট্র্যাক করুন পৃষ্ঠা কত ঘন ঘন প্রকৃতপক্ষে দেখা হয়, এবং পৃথকভাবে, এটি যে অন্তর্নিহিত সিস্টেম বর্ণনা করে তা কত ঘন ঘন পরিবর্তিত হয়েছে তার সাপেক্ষে একটি পৃষ্ঠা শেষবার আপডেট হওয়ার পর থেকে কত সময় পেরিয়েছে (বিষয় ৪.৩ থেকে churn উপাত্ত ক্রস-রেফারেন্স করা এখানে সরাসরি দরকারী)। একটি পৃষ্ঠা যা এমন একটি সিস্টেম বর্ণনা করে যা পৃষ্ঠাটি শেষবার সম্পাদিত হওয়ার পর থেকে যথেষ্ট পরিবর্তিত হয়েছে শুধু অসহায়ক হওয়ার চেয়ে সক্রিয়ভাবে বিভ্রান্তিকর হওয়ার একটি শক্তিশালী প্রার্থী, এবং এই পুরনোত্ব সংকেত নথিপত্র মোটেও বিদ্যমান কিনা তা ট্র্যাক করার চেয়ে কমপক্ষে ততটাই মনোযোগের যোগ্য।

একটি আবিষ্কারযোগ্যতা সংকেত হিসেবে পুনরাবৃত্ত প্রশ্নের জন্য দেখুন

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

প্রথম অর্থপূর্ণ, স্বাধীন অবদানে অনবোর্ডিং সময় পরিমাপ করুন

বিষয় ৩.৫-এ একটি সহযোগিতা সংকেত হিসেবে প্রবর্তিত এই মেট্রিক, কোড পক্ষ থেকে সমানভাবে একটি নথিপত্র ও জ্ঞান-স্বাস্থ্য সংকেত। একটি ধারাবাহিকভাবে সংক্ষিপ্ত, ভবিষ্যদ্বাণীযোগ্য অনবোর্ডিং সময় প্রকৃতপক্ষে সহজলভ্য, সঠিক জ্ঞান পরামর্শ দেয়; একটি দীর্ঘ, অত্যন্ত পরিবর্তনশীল সময়, বিশেষত একটি যা কোন নির্দিষ্ট ব্যক্তি একজন নতুন দল সদস্যকে অনবোর্ড করেন তার উপর ভারীভাবে নির্ভর করে, জ্ঞান পরামর্শ দেয় যা টেকসই, লিখিত রূপের বদলে ব্যক্তিগত স্মৃতিতে বিপজ্জনকভাবে কেন্দ্রীভূত বাস করে।

স্পষ্টভাবে অনথিভুক্ত সমালোচনামূলক-জ্ঞান ক্ষেত্র চিহ্নিত ও অগ্রাধিকার দিন

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

আপনার প্রযুক্তিগত ঋণ ব্যাকলগের মধ্যে একটি শ্রেণী হিসেবে নথিপত্র ঋণ বিবেচনা করুন

নথিপত্র ফাঁক পৃথকভাবে ও অনানুষ্ঠানিকভাবে ট্র্যাক করার বদলে, উল্লেখযোগ্য নথিপত্র ফাঁককে বিষয় ৪.৫-এ বর্ণিত একই দৃশ্যমান, পরিমাণগত ব্যাকলগে ভাঁজ করুন, বিশেষত সমালোচনামূলক, নিম্ন-বাস-ফ্যাক্টর সিস্টেমের জন্য, যাতে নথিপত্র কাজ কোড-কেন্দ্রিক ঋণ প্রতিকারের তুলনায় একটি নিম্ন-মর্যাদার কাজ হিসেবে চিরস্থায়ীভাবে বিলম্বিত হওয়ার বদলে অগ্রাধিকারপ্রাপ্ত ক্ষমতার জন্য ন্যায্যভাবে প্রতিযোগিতা করে।

মূল্যবিচার: ভালো ও মন্দ দিক

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

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

আপনার দলের সাথে আলোচনার প্রশ্ন

১. আমাদের সবচেয়ে সমালোচনামূলক, সর্বনিম্ন-বাস-ফ্যাক্টর সিস্টেমের জন্য, অর্থপূর্ণ, সঠিক নথিপত্র কি প্রকৃতপক্ষে বিদ্যমান, নাকি একজন প্রস্থানকারী বিশেষজ্ঞ তাদের সাথে বেশিরভাগ প্রকৃত জ্ঞান নিয়ে যাবেন? এটি এই বিষয়ের কেন্দ্রীয় উদ্বেগের সবচেয়ে তীক্ষ্ণ, সুনির্দিষ্ট সংস্করণ; প্রথমে আপনার একক সবচেয়ে ঝুঁকিপূর্ণ সিস্টেমের জন্য সততার সাথে এর উত্তর দিন।

২. কোথাও একটি নথিভুক্ত উত্তর বিদ্যমান থাকা সত্ত্বেও আমাদের দলের চ্যাটে কোন প্রশ্ন বারবার জিজ্ঞাসা করা হয়? যদি আপনি অবিলম্বে একটি নাম দিতে পারেন, সেটি সরাসরি ঠিক করার যোগ্য একটি আবিষ্কারযোগ্যতা সমস্যা, সম্ভবত আরও লেখার বদলে বিদ্যমান বিষয়বস্তু পুনর্গঠন বা আরও ভালোভাবে প্রকাশ করে।

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

৪. আমরা সর্বশেষ কখন পরীক্ষা করেছি একটি নথিপত্র এখনও সঠিক কিনা, এটি লেখা হওয়ার পর থেকে অন্তর্নিহিত সিস্টেম কতটা পরিবর্তিত হয়েছে তার সাপেক্ষে? যদি সৎ উত্তর হয় “আমরা পদ্ধতিগতভাবে এটি পরীক্ষা করি না,” সেই পুরনোত্ব ঝুঁকি সম্ভবত এখন যে কেউ ধরে নেয় তার চেয়ে বড়।

৫. আমাদের প্রযুক্তিগত ঋণ ব্যাকলগে (বিষয় ৪.৫) কি নথিপত্র ফাঁক অন্তর্ভুক্ত, নাকি নথিপত্র কাজ কোড সমাধানের তুলনায় একটি নিম্ন-মর্যাদার কাজ হিসেবে চিরস্থায়ীভাবে বিলম্বিত হয়? আপনার প্রকৃত ব্যাকলগ পরীক্ষা করুন এবং দেখুন নথিপত্র ঋণ দৃশ্যমান ও অগ্রাধিকারপ্রাপ্ত ক্ষমতার জন্য প্রতিযোগিতা করছে নাকি কার্যকরভাবে অদৃশ্য।

৬. আমাদের সবচেয়ে সমালোচনামূলক, সর্বনিম্ন-নথিভুক্ত সিস্টেম বোঝেন এমন এক বা দুইজন মানুষ একই বছরের মধ্যে চলে গেলে এটি আমাদের কী খরচ করবে? এই সুনির্দিষ্ট, অস্বস্তিকর প্রশ্ন ঝুঁকিকে বিমূর্ত বা অসম্ভাব্য হিসেবে বিবেচনা করার বদলে সততার সাথে উত্তর দেওয়ার যোগ্য।

ক্ষেত্র লেন্স

স্টার্টআপ। একটি ছোট দলসহ আনুষ্ঠানিক নথিপত্র মেট্রিক সাধারণত অপ্রয়োজনীয় যেখানে জ্ঞান ক্রমাগত, সরাসরি কথোপকথনের মাধ্যমে ছড়িয়ে পড়ে। দেখার ঝুঁকিটি একই বাস-ফ্যাক্টর কেন্দ্রীকরণ যার বিরুদ্ধে বিষয় ৩.৫ সতর্ক করে, এখন নির্দিষ্টভাবে নথিপত্রে প্রয়োগ করা: দল সবাই দৈনিক কথা বলে এমন আকার অতিক্রম করে বৃদ্ধি পাওয়ার সাথে সাথে, অনথিভুক্ত জ্ঞান যা অনানুষ্ঠানিকভাবে ঠিকঠাক কাজ করেছিল একটি প্রকৃত দায় হয়ে ওঠে।

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

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

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

উদাহরণ

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

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

ব্যবসায়িক যুক্তি: প্রেরণা, ROI, এবং TCO

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

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

বিরোধী প্যাটার্ন এবং ফাঁদ

• উপযোগিতার বদলে নথিপত্র অস্তিত্ব গণনা করা: প্রয়োজনের সময় জ্ঞান প্রকৃতপক্ষে সহজলভ্য কিনা তার সম্পর্কে প্রায় কিছুই বলে না।
• প্রথমে আবিষ্কারযোগ্যতা পরীক্ষা না করে পুনরাবৃত্ত প্রশ্নের প্রতিক্রিয়ায় আরও বিষয়বস্তু লেখা: প্রায়ই সম্পূর্ণভাবে ভুল সমস্যা সমাধান করে।
• সিস্টেম কতটা পরিবর্তিত হয়েছে তার সাপেক্ষে কখনও নথিপত্র পুরনোত্ব পরীক্ষা না করা: সক্রিয়ভাবে বিভ্রান্তিকর, পুরনো বিষয়বস্তুর ঝুঁকি নেয়।
• নথিপত্র ঋণকে কোড ঋণের চেয়ে চিরস্থায়ীভাবে নিম্ন-মর্যাদা হিসেবে বিবেচনা করা: এটিকে দীর্ঘস্থায়ীভাবে অগ্রাধিকার-হ্রাসকৃত ও ব্যাকলগে অদৃশ্য রেখে দেয়।
• আপাত স্থিতিশীলতা, একটি সিস্টেম যা বছরের পর বছর পরিবর্তিত হয়নি, কে নিম্ন ঝুঁকি বলে ভুল করা: একটি গুরুতর, অনথিভুক্ত বাস-ফ্যাক্টর সমস্যা লুকাতে পারে এমন একটি সিস্টেমের পেছনে যার শুধু এখনও এর একমাত্র বিশেষজ্ঞ প্রয়োজন হয়নি।
• শুধুমাত্র একটি জরুরি কর্মী স্থানান্তরের সময় সমালোচনামূলক অনথিভুক্ত জ্ঞান আবিষ্কার করা: এই বিষয় প্রতিরোধ করতে নির্মিত ব্যয়বহুল, এড়ানোযোগ্য ব্যর্থতার ধরন।

পরিপক্বতা মডেল

• স্তর ১, শুরু: নথিপত্র স্বাস্থ্য পরিমাপ করা হয় না; জ্ঞান কেন্দ্রীকরণ ও পুরনোত্ব ঝুঁকি শুধুমাত্র সংকটের মাধ্যমে আবিষ্কৃত হয়।
• স্তর ২, উন্নয়ন: কিছু নথিপত্র বিদ্যমান, কিন্তু প্রবেশ, পুরনোত্ব, বা আবিষ্কারযোগ্যতার কোনো পদ্ধতিগত ট্র্যাকিং নেই।
• স্তর ৩, মানসম্মতকরণ: সমালোচনামূলক সিস্টেমের জন্য প্রবেশ ও পুরনোত্ব ট্র্যাক করা হয়, এবং প্রতিষ্ঠান-ব্যাপী জ্ঞান স্বাস্থ্যের একটি প্রক্সি হিসেবে অনবোর্ডিং সময় পরিমাপ করা হয়।
• স্তর ৪, ব্যবস্থাপনা: নথিপত্র ফাঁক অগ্রাধিকারপ্রাপ্ত প্রযুক্তিগত ঋণ ব্যাকলগে ভাঁজ করা হয়, সবচেয়ে গুরুতর সম্মিলিত ঝুঁকি চিহ্নিত করতে বাস-ফ্যাক্টর ঝুঁকির সাথে ক্রস-রেফারেন্স করা।
• স্তর ৫, সমন্বয়: প্রতিষ্ঠান একটি স্টাফিং স্থানান্তর সমস্যাটি বাধ্য করার আগে সক্রিয়ভাবে অনথিভুক্ত সমালোচনামূলক-জ্ঞান ঝুঁকি চিহ্নিত ও সমাধান করে, এবং নথিপত্র বিনিয়োগে ফিরে খুঁজে পাওয়া নির্দিষ্ট, পরিমাপযোগ্য অনবোর্ডিং বা ঘটনা-প্রতিক্রিয়া উন্নতি নির্দেশ করতে পারে।

আলোচনার জন্য ধারণা

১. এখন নিম্ন বাস ফ্যাক্টর ও খারাপ নথিপত্রের আমাদের একক সবচেয়ে গুরুতর সংমিশ্রণ কী? ২. একটি নথিভুক্ত উত্তর বিদ্যমান থাকা সত্ত্বেও কোন প্রশ্ন বারবার জিজ্ঞাসা করা হয়? ৩. একটি সমালোচনামূলক নথিপত্র পুরনো ও বিভ্রান্তিকর হয়ে উঠলে আমরা কীভাবে জানব? ৪. আমাদের প্রযুক্তিগত ঋণ ব্যাকলগে কি নথিপত্র ফাঁক অন্তর্ভুক্ত, নাকি তারা অদৃশ্য? ৫. আমাদের সবচেয়ে কম-নথিভুক্ত সিস্টেমের একমাত্র বিশেষজ্ঞ এই বছর চলে গেলে এটি আমাদের কী খরচ করবে?

মূল বিষয়সমূহ

• প্রবেশ প্যাটার্ন, পুরনোত্ব, এবং পুনরাবৃত্ত প্রশ্নের মতো প্রক্সি ব্যবহার করে উপযোগিতা, অস্তিত্ব নয় পরিমাপ করুন: নথিপত্র প্রকৃতপক্ষে সাহায্য করে কিনা।
• নথিভুক্ত উত্তর থাকা সত্ত্বেও পুনরাবৃত্ত প্রশ্ন একটি আবিষ্কারযোগ্যতা সমস্যা প্রকাশ করে, অগত্যা একটি বিষয়বস্তু-প্রচেষ্টা সমস্যা নয়।
• উৎপাদনশীল অবদানে অনবোর্ডিং সময় সামগ্রিক জ্ঞান স্বাস্থ্যের একটি শক্তিশালী, ব্যবহারিক প্রক্সি।
• অনথিভুক্ত সমালোচনামূলক জ্ঞান একটি যৌগিক ঝুঁকি, বিশেষত একটি নিম্ন বাস ফ্যাক্টরের (বিষয় ৩.৫) সাথে একত্রিত হলে; এটি দৃশ্যমানভাবে কিছুই খরচ করে না যতক্ষণ না এটি একবারে অনেক কিছু খরচ করে।
• নথিপত্র ফাঁককে আপনার প্রযুক্তিগত ঋণ ব্যাকলগে (বিষয় ৪.৫) ভাঁজ করুন যাতে তারা অগ্রাধিকারপ্রাপ্ত ক্ষমতার জন্য ন্যায্যভাবে প্রতিযোগিতা করে।

তথ্যসূত্র এবং অতিরিক্ত পাঠ

• Bhatti, Jared, Zachariah Goldberg, Ted Kubaska, and Sarah Moir. Docs for Developers: An Engineer’s Field Guide to Technical Writing. Apress, 2021.
• Ousterhout, John. A Philosophy of Software Design. Yaknyam Press, 2018.
• Skelton, Matthew, and Manuel Pais. Team Topologies: Organizing Business and Technology Teams for Fast Flow. IT Revolution Press, 2019.
• Forsgren, Nicole, Jez Humble, and Gene Kim. Accelerate: The Science of Lean Software and DevOps. IT Revolution Press, 2018.