ডেভেলপাররা اکثر সময় খারাপ নথিয়ানকরণ লিখে, মনে করে যে ব্যবহারকারীরা তাদের মতো পক্ষপাত এবং জ্ঞান ভাগ করে। এই সমস্যা দূর করতে, লেখকটি বাস্তব ব্যবহারকারীদের প্রতি ঘন্টা 25 ইউরো দিয়ে তাদের Activity Bot README-এর পরীক্ষা করিয়েছিল, যেখানে তারা নির্দেশাবলী উচ্চরে পড়ते हुए স্ক্রীন শেয়ার করত। এই প্রক্রিয়াটি গুরুত্বপূর্ণ ত্রুটিগুলো উন্মোচন করেছিল: ভাঙা ডেমো লিঙ্ক, বিভ্রান্তিকর ফাইল নাম পরিবর্তনের ধাপ, অস্পষ্ট প্রযুক্তিগত শব্দ, বিভাগের খराब ক্রম এবং সফটওয়্যারের উদ্দেশ্য ব্যাখ্যা না করা। লেখক হস্তলিখিত নোট নিল, প্রতিটি সেশনের পর README আপডেট করিল এবং নতুন ব্যবহারকারীদের সাথে পুনরায় পরীক্ষা করিল। বেশ কিছু সেশনের মাধ্যমে, mereka স্পষ্ট প্রতিক্রিয়া জন্য 150 ইউরো দিল। এই প্রক্রিয়াটি দেখিয়েছে যে বাস্তব ব্যবহারকারীরা গোপন ধারণাগুলো উন্মোচন করে — যেমন sudo এর প্রয়োজন, রিবুটের প্রয়োজন এবং উদ্ধৃতি নিয়ম — যা ডেভেলপাররা প্রায়শই উপেক্ষা করে। LLMs-এর বিপরীতে, বাস্তব মানুষ হাস্য, অনন্য দৃষ্টিভঙ্গি এবং দুঃখের মতো আবেগগত সংকেত আনে, যা নথিয়ানকরণের ব্যর্থতা নির্দেশ করে। লেখক তার GOV.UK প্রযুক্তিগত লিখার অভিজ্ঞের সাথে এই তুলনা করেন, যেখানে মানব পর্যালোচনা ফুলের মতো গদ্যকে स्पষ্ট, ব্যবহারযোগ্য নথিয়ানকে পরিণত করে। যদিও README এখনও পরিপূর্ণ নয়, এখন এটি স্পষ্টভাবে অনুসরণ করার জন্য সহজ। মূল শিক্ষা: ডেভেলপারদের নথিয়ানকরণের পরীক্ষা বাস্তব মানুষদের সাথে করা উচিত যারা ভ ausgelে চিন্তা করেন,即使未付费, যাতে aveugল বিন্দুগুলো খুঁজে পayout করা যায় এবং ব্যবহারযোগ্যতা উন্নত করা যায়।
উৎস: Hacker News · সারাংশ: HeadlinesBriefing