मैं किसी भी प्रलेखन के साथ विश्वास करता हूं कि चुस्त दृष्टिकोण एक अच्छा है। अब, वहाँ कुछ गलतफहमी है कि चुस्त का मतलब है "कोई प्रलेखन या विश्लेषण बिल्कुल नहीं" लेकिन ऐसा नहीं है। फुर्तीले के बारे में मैंने जो कुछ पढ़ा है, वह कहता है, "जो काम करता है उसका उपयोग करें।" मुझे लगता है कि दस्तावेज़ की लंबाई और विस्तार कार्य के अनुरूप होना चाहिए।
चेकलिस्ट के रूप में टेम्प्लेट मददगार हो सकते हैं, लेकिन मुझे छोटे या कम जोखिम वाले परिवर्तनों के लिए हर सेक्शन को भरने की आवश्यकता नहीं होगी। एक पंक्ति में बदलाव के लिए, शायद आपको किसी डॉक्टर की आवश्यकता नहीं है। मैंने कभी भी एक प्रभाव विश्लेषण दस्तावेज़ के लिए टेम्पलेट का उपयोग नहीं किया है, लेकिन मैं नियमित रूप से व्यावसायिक आवश्यकताओं या तकनीकी चश्मे से निपटता हूं। एक टेम्पलेट बहुत अधिक प्रतिबंधक हो सकता है; एक अच्छा दिशानिर्देश यह सोचने के बजाय है कि दर्शक कौन होंगे। यदि यह ऐसे प्रबंधकों के लिए है जो तकनीकी नहीं हैं, तो परिवर्तन के लिए व्यावसायिक औचित्य पर ध्यान केंद्रित करें। यदि यह तकनीकी लोगों के लिए है, तो थोड़ी सी पृष्ठभूमि प्रदान करें ताकि टीम के एक नए व्यक्ति को खोना न पड़े और अगर उन्हें बदलाव का समर्थन करना हो तो उन्हें पर्याप्त जगह मिल सके। इसके अलावा, यदि आप कुछ और भी घर्षण-कम और हल्के चाहते हैं, तो एक डॉक्टर का उपयोग न करें, इसे विकी पर रखें।
शामिल करने के लिए जानकारी:
- मुद्दे का संक्षिप्त विवरण
- दोष या / या अक्षमता के कारण दोष का उदाहरण या व्याख्या करें
- जटिलता का अनुमान शामिल करें
- लागत और फिक्स के लिए समय का अनुमान शामिल करें
यह एक सभ्य न्यूनतम है। दूसरे पोस्ट में आईबीएम से कुछ बहुत भारी सीएमएमआई सामान पर प्रकाश डाला गया; यह बहुत अच्छा है यदि आपके पास इसके लिए समय और संसाधन हैं (और जब आप नासा के लिए सिस्टम का निर्माण कर रहे हैं जहां मानव जीवन दांव पर है, तो लोग बेहतर तरीके से इसके बारे में गंभीर हो सकते हैं) लेकिन छोटी टीमों के लिए आपको शायद इतना भारी होने की आवश्यकता नहीं है। । हमेशा की तरह, अनुमान के साथ सावधान रहें। प्रबंधकों का अनुमान है कि वास्तविक होने का खतरा है।
ध्यान दें कि चुस्त दृष्टिकोण में खतरे हैं। कुछ डेवलपर्स को लगता है कि इसका मतलब है, "कोई डॉक्स की आवश्यकता नहीं है, बस दूर हैकिंग शुरू करें" (जो कुछ स्थितियों में ठीक हो सकता है)। इसके अलावा, अन्य लोग दिए गए अक्षांश को कार्य में ले लेंगे और बस वास्तव में भद्दे डॉक्स लिखेंगे जो वास्तव में मदद नहीं करते हैं (ज्यादातर स्थितियों में जरूरी नहीं कि ठीक हो)। समस्या का हिस्सा यह है कि लेखन में कुछ प्रयास, कौशल और समय लगता है; हम में से अधिकांश उन चीजों में से कम से कम दो पर कम हैं;)
मैं हमेशा प्रलेखन पर बड़ा रहा हूं क्योंकि यह आपको कम से कम एक योजना के रूप में अर्हता प्राप्त करने के लिए पर्याप्त विचार में डाल देता है। लेकिन मेरे बुढ़ापे में मैं यह भी सराहना करने के लिए आया हूं कि बहुत अधिक प्रलेखन स्वयं एक रखरखाव परेशानी बन सकता है, और यह कि पर्याप्त लोगों को प्रलेखन अद्यतन रखने के लिए पर्याप्त देखभाल नहीं है।