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