डेवलपर अक्सर खराब दस्तावेज़ लिखते हैं, मानते हैं कि उपयोगकर्ता उनके समान पक्षपात और ज्ञान साझा करते हैं। इसे दूर करने के लिए, लेखक ने वास्तविक उपयोगकर्ताओं को प्रति घंटा 25 यूरो का भुगतान करके अपने Activity Bot README का परीक्षण करवाया, जिसमें वे निर्देशों को głos में पढ़ते हुए अपने स्क्रीन साझा करते थे। इससे महत्वपूर्ण दोष सामने आए: टूटे हुए डेमो लिंक, भ्रमित करने वाले फ़ाइल नाम बदलने के चरण, अस्पष्ट तकनीकी शब्द, खंडों का खराब क्रम और सॉफ़्टवेयर के उद्देश्य की स्पष्ट व्याख्या नहीं। लेखक ने हाथ से लिखित नोट लिए, प्रत्येक सत्र के बाद README अपडेट किया और नए उपयोगकर्ताओं के साथ फिर से परीक्षण किया। कई सत्रों में, उन्होंने ईमानदार प्रतिक्रिया के लिए 150 यूरो का भुगतान किया। इस प्रक्रिया ने उजागर किया कि वास्तविक उपयोगकर्ता छिपी हुई धारणाओं को उजागर करते हैं — जैसे sudo की आवश्यकता, रीबूट की आवश्यकता और उद्धरण नियम — जो डेवलपर अक्सर अनदेखा करते हैं। LLMs के विपरीत, वास्तविक लोग हास्य, अद्वितीय दृष्टिकोण और भावनात्मक संकेत जैसे निराशा लाते हैं, जो दस्तावेज़ीकरण की विफलता को इंगित करते हैं। लेखक इसकी तुलना अपने GOV.UK तकनीकी लेखन अनुभव से करते हैं, जहां मानव समीक्षा ने फूल भरी भाषा को स्पष्ट, उपयोगी दस्तावेज़ में बदल दिया। हालांकि README अभी भी पूर्ण नहीं है, लेकिन अब इसका पालन करना स्पष्ट रूप से आसान है। मुख्य सबक: डेवलपर को दस्तावेज़ीकरण का परीक्षण वास्तविक लोगों से करना चाहिए जो głos में सोचते हैं, भले ही अनभुगतान हों, ताकि अंधे बिंदुओं को खोजा जा सके और उपयोगिता में सुधार किया जा सके।
स्रोत: Hacker News · HeadlinesBriefing द्वारा सारांशित