आप केवल उपयोगकर्ता की कहानियां नहीं रख सकते हैं किसी भी तरह प्रोग्राम की कार्यक्षमता को दस्तावेज किया जाना है। क्या आप स्क्रम के साथ एक विनिर्देश दस्तावेज के साथ खत्म हो? यदि आप करते हैं तो आप कार्य पर ऐसा करने के लिए समय निर्दिष्ट करते हैं?स्क्रम और आवश्यकताएं
एक उदाहरण एक जटिल वर्कफ़्लो होगा।
एक और उदाहरण टीम पर आने वाला एक नया सदस्य होगा।
प्रत्येक उपयोगकर्ता कहानी पर एक कार्य के रूप में "प्रलेखन" जोड़ना निश्चित रूप से आपके लक्ष्य की दिशा में एक लंबा रास्ता तय कर सकता है।
जेम्स कोल्पैक के अलावा, परियोजना की कहानी समाप्त होने के बाद उपयोगकर्ता की कहानी मानचित्र जारी रहना चाहिए क्योंकि यह भी दस्तावेज़ीकरण का एक रूप है। मेरा मानना है कि हम कुछ लोगों के लिए योजना बनाते हैं जो इसे हमारे दस्तावेज़ में परिवर्तित करते हैं जो हमारे विकी में रहता है जब सब कुछ कहा जाता है और किया जाता है।
विचार यह है कि यह दस्तावेज़ उन लोगों के लिए उपयोगी होगा जिन्हें सिस्टम को बनाए रखने या भविष्य में इसमें वृद्धि जोड़ने की आवश्यकता है क्योंकि उन्हें उपयोगकर्ता के परिप्रेक्ष्य की समझ होगी।
इस प्रश्न में बहुत सारे अच्छे विचार जोड़े जाएंगे। मेरे व्यक्तिगत अनुभव ने मुझे सिखाया है कि:
1 ~ कामकाजी उत्पाद स्वयं प्रलेखन का एक रूप है: यह मानते हुए कि उत्पाद स्वीकार कर लिया गया है, फिर पूछें कि कुछ शर्त के तहत इसे क्या करना चाहिए यह पूछने के बराबर है कि यह वास्तव में उन लोगों के तहत क्या करता है शर्तें - लॉग इन करें और अपना उत्तर प्राप्त करने का प्रयास करें।
2 ~ परीक्षण, मैन्युअल या स्वचालित (या मिश्रण) हो, दस्तावेज़ीकरण का एक रूप है। निश्चित रूप से यूनिट परीक्षण कम तकनीकी रूप से इच्छुक टीम के सदस्यों (जैसे: 'व्यवसाय विशेषज्ञ' या ग्राहक) द्वारा बोली जाने वाली डोमेन भाषा से बहुत दूर हो सकते हैं। स्वीकृति परीक्षण क्रम के 'मध्यम मैदान' के करीब हो सकता है। निश्चित रूप से बीडीडी-स्टाइल परीक्षणों में एक सर्वव्यापी भाषा बनाने का सबसे अच्छा मौका होता है जो हर कोई समझ सकता है (इस संबंध में देखें Gojko's Bridging the Communication Gap)। फिर भी, इन सभी प्रकार के परीक्षण दस्तावेज का एक रूप है जिसका उपयोग यह निर्धारित करने के लिए किया जा सकता है कि उत्पाद को क्या करना चाहिए।
3 ~ इस पर निर्भर करता है कि आपकी परियोजना स्पेक्ट्रम पर कहां गिरती है, आपके दस्तावेज़ (और, सामान्यतः, आपके सभी सहायक कलाकृतियों) को उच्च या निम्न डिग्री की आवश्यकता हो सकती है। छोटे उत्पाद, छोटी टीम, जहां बाजार के लिए समय महत्वपूर्ण है, यह पता लगा सकता है कि आवश्यकता के एक बहुत ही औपचारिक दस्तावेज़ीकरण के मूल्य की तुलना में बहुत अधिक लागत है। दूसरी तरफ, कई टीमों और विकास के वर्षों में फैले बेहद बड़ी परियोजनाओं को औपचारिक दस्तावेज का आरओआई काफी अलग मिलेगा।
4 ~ सही दुनिया में, हमें शायद कामकाजी कोड के रूप में अन्य आवश्यकताओं को दस्तावेज करने की आवश्यकता नहीं होगी (जो, हाथीदांत टॉवर में स्वयं स्पष्टीकरण भी होगा) और परीक्षण (ज्यादातर रिग्रेशन परीक्षण के लिए, और नई सुविधाओं के विकास को चलाने के लिए - सीमा पर)। इस प्रकार, आवश्यकता दस्तावेज का सवाल परफेक्ट वर्ल्ड/आइवरी टॉवर और रियल वर्ल्ड/ट्रेंच के बीच क्या अंतर है, इस बारे में एक प्रश्न है। उत्तर, ज़ाहिर है, परियोजना और टीम के आधार पर मामले-दर-मामले पर अलग है। उदाहरण के लिए, हम कह सकते हैं "सभी आवश्यकताओं को इस विकी में रखा जाएगा, और अत्यधिक देखभाल, इत्यादि के साथ बनाए रखा जाएगा ..." लेकिन यदि टीम विकी के साथ परिचित और आरामदायक नहीं है तो यह काम नहीं करेगी।
5 ~ अंत में, हितधारकों को आपसे पूछना चाहिए। निश्चित रूप से, विषय को एक सहयोगी तरीके से संपर्क किया जाना चाहिए, क्योंकि टीम के हर व्यक्ति को पूरे परियोजना में आवश्यकताओं के साथ बातचीत करनी होगी, लेकिन आपको दस्तावेज का एक रूप मिलना चाहिए जो हितधारकों की जरूरतों को पूरा करता है।
सभी ही कहा जा रहा है, यहाँ कुछ स्थानों मैं आवश्यकताओं देखा प्रलेखित किया है, जबकि स्क्रम लागू करने है (मैं की तरह इस शब्द हमेशा एक तारक द्वारा पालन किया जाना चाहिए क्यों लग रहा है?):
नोटों और, ईमानदारी से, मैं नहीं कर सकता कहें कि किसी भी एक प्रणाली के साथ दूसरों की तुलना में एक सफल परियोजना के साथ लगातार उच्च सहसंबंध है। मुझे लगता है, वास्तव में, हमारे पास चांदी की गोली नहीं है।
एचटीएच, विचार-विमर्श करने वाले प्रश्न के लिए धन्यवाद!
शायद प्रश्न की मेरी समझ पूरी तरह से गलत है, लेकिन मुझे जो समझ में आया वह यह था कि ओपी उपयोगकर्ता कहानियों और आवश्यकताओं के बीच मेल के साथ असहज था। कारण के साथ मैं कहूंगा।
मेरी राय में, उपयोगकर्ता कहानियों बताने के लिए कार्यक्षमता का एक हिस्सा उत्पाद मालिक करने के लिए प्रदर्शन किया जाएगा। कहानी की भाषा कुछ ऐसा हो सकता है जिसे उत्पाद के मालिक द्वारा समझा जा सकता है लेकिन मुख्य रूप से डेवलपर्स द्वारा। आपके पास ऐसी कहानियां हो सकती हैं जो उन चीजों का वर्णन करती हैं जिन्हें मालिक द्वारा सीधे भी आवश्यक नहीं है, लेकिन वे चीजों के टूटने हैं।
दूसरे हाथ मेंआवश्यकताओं प्रणाली क्या करने की जरूरत के क्रम में मान्य होने के लिए के डोमेन उपयोगकर्ता की भाषा में एक विस्तृत विवरण है। कई मामलों में एक आवश्यकता दस्तावेज वैकल्पिक नहीं है (उदाहरण के लिए निश्चित मूल्य परियोजनाएं)।
मैं जो करता हूं वह दोनों का मिश्रण है। मेरे पास एक आवश्यकता दस्तावेज है, और मेरी अधिकांश स्क्रम कहानियों में, मेरे पास मेरे नोट्स में कुछ है जो उस कहानी को आवश्यकताओं के एक या एक से अधिक आइटम से जोड़ता है। यह जितना आसान है "देखें FR-042 और FR-45" (उदाहरण के लिए कार्यात्मक आवश्यकता के लिए एफआर)
स्क्रम कहते हैं कि आप दस्तावेज़ चाहिए आपको क्या चाहिए, जब आप इसे की जरूरत है; यह नहीं कहता कि आपके पास दस्तावेज़ नहीं होना चाहिए।
इसलिए यदि किसी दस्तावेज़ को तैयार उत्पाद (जैसे सहायता दस्तावेज़) द्वारा तैयार किया गया है या तैयार उत्पाद (उदाहरण के लिए आवश्यक दस्तावेज) तैयार करना है तो आपके उत्पाद बैकलॉग में एक दस्तावेज़ कार्य/उपयोगकर्ता कहानी होनी चाहिए।
उचित प्राथमिकता तो उस कार्य के लिए रखा जाना चाहिए।
प्रलेखन के लिए मुख्य बिंदु है; केवल
तुम बस उपयोगकर्ता कहानियों किसी भी तरह कार्यक्रम की कार्यक्षमता प्रलेखित किया जाना है नहीं हो सकता। क्या आप स्क्रैम के साथ एक विनिर्देश दस्तावेज़ के साथ समाप्त होते हैं? यदि आप कार्य पर ऐसा करने के लिए समय निर्दिष्ट करते हैं तो आप समाप्त करते हैं?
आपके पास उपयोगकर्ता कहानियां क्यों नहीं हो सकती हैं? इन विनिर्देश दस्तावेजों का क्या उद्देश्य है? इन दस्तावेजों के उत्पादन में निवेश का क्या मूल्य है? क्या लाभ लागत का वजन करता है? यदि नहीं, तो क्या समय बिताया गया समय नहीं है, और अधिक महत्वपूर्ण रूप से बनाए रखने के लिए, ये दस्तावेज़ बर्बाद हो जाते हैं?
मुझे पता है कि मैं उत्तर देने से अधिक प्रश्न पूछ रहा हूं, लेकिन मुझे लगता है कि दुबला करने की तरह स्क्रम और अन्य एजिल दृष्टिकोण क्या है, यह है कि आप अपने वर्तमान प्रथाओं की पुन: जांच करें और देखें कि क्या वे अभी भी समझ में हैं या नहीं।
विनिर्देशों के मामले में, सुविधा लॉन्च होने के बाद इन दस्तावेजों को अपडेट और बनाए रखेगा? अधिकांश कंपनियों में मैं रहा हूं, प्रलेखन बहुत पुराना है, पुराना है, या शायद ही कभी संदर्भित किया गया है।
इसके बजाय, निष्पादन योग्य परीक्षण या बीडीडी का उपयोग क्यों न करें ताकि दस्तावेज़ कोड का हिस्सा बन जाए और निष्पादन योग्य हो। उदाहरण के लिए, Ben Mabey's talk on Cucumber
देख किसी कारण से, दस्तावेज़ के एक विशिष्ट प्रकार के कानूनी अनुपालन उद्देश्यों के लिए आवश्यक है, तो आप हमेशा "हो गया" की टीमों का भी परिभाषा में जोड़ सकते हैं, हालांकि, मैं ज्यादातर मामलों में पाया है , कहानियां और परीक्षण दस्तावेज के पर्याप्त रूपों से अधिक हैं।
मैं ज्यादातर टोड से सहमत हैं, लेकिन कई बार ऐसा था जब मेरी टीम के काम का हिस्सा प्रलेखन के उत्पादन के लिए किया गया था: प्रलेखन उपयोगकर्ता कहानी खुद हमारे पीओ दिया जा करने के लिए कहा था।
इन मामलों में हम निम्नलिखित दिशा निर्देशों का पालन वास्तविक कार्यक्रम और दस्तावेजों का निर्माण)।
मेरा अनुभव है कि दस्तावेजों आसान लिख सकते हैं और परीक्षण के कुछ प्रकार के सक्षम करने के लिए बनाता है में (आप किसी को पीओ से पूछते हैं, आम तौर पर, दस्तावेज़ पढ़ सकते हैं और अगर यह लक्ष्य पर विचार ठीक है कहने के लिए)।
आप अपने सिस्टम को सत्यापित करने के लिए दस्तावेज़ लिखते हैं। यदि उपयोगकर्ता प्रणाली के साथ उपयोगकर्ता के संपर्क को दर्शाता है तो प्रारूप में सही ढंग से लिखा गया है, तो उपयोगकर्ता कहानियां एक ही उद्देश्य की सेवा करती हैं। मैं बीडीडी का उपयोग करने और गेरकिन सिंटैक्स का उपयोग करके कहानियां लिखने की सिफारिश करूंगा। आखिरकार आपके परिदृश्य आपके स्वीकृति मानदंड बन जाते हैं जो सत्यापन में मदद करता है कि क्या सिस्टम सही तरीके से काम कर रहा है या नहीं।
हम एक डॉक्स टीम है कि हमारे उत्पाद के लिए "अनुदेश पुस्तिका" का उत्पादन किया है। मैनुअल को उत्पाद की मुख्य विशेषताओं, और उन कार्यों में उपयोगकर्ता द्वारा किए जा सकने वाले कार्यों के आसपास संरचित किया गया है।
प्रत्येक स्प्रिंट, स्क्रम टीमों कि उत्पाद सुविधाओं में कार्यक्षमता जोड़ने के उपयोगकर्ता कहानियों पर काम करते हैं।
स्प्रिंट की योजना बना करने के बाद, स्क्रम टीम के साथ डॉक्स टीम मिलने और देखते हैं जो उपयोगकर्ता कहानियों कि इस स्प्रिंट विकसित किया जाएगा। डॉक्स टीम प्रारंभिक दस्तावेज़ लिखकर निर्देश मैनुअल को बढ़ाने शुरू कर देती है। स्प्रिंट के दौरान, दस्तावेज़ टीम उपयोगकर्ता कहानियों की प्रगति का पालन करती है, और उत्पाद का उपयोग कर सकती है क्योंकि इसे पर्यावरण परीक्षण के लिए तैनात किया गया है। स्प्रिंट के अंत में, finialise अद्यतन अनुदेश पुस्तिका डॉक्स टीम और रिहाई प्रत्येक स्प्रिंट के हिस्से के रूप आदि अंतिम स्क्रीन शॉट्स जोड़ने ...
अनुदेश पुस्तिका जहाज।
मुझे लगता है कि आप यहां कुछ अलग-अलग चीजों के लिए पूछ रहे हैं। यदि आप एक नया टीम सदस्य जोड़ रहे हैं, तो सिस्टम के लिए प्रलेखन ऑन-बोर्डिंग प्रक्रिया के हिस्से के रूप में टीम पर उनकी भूमिका के लिए तैयार किया जाना चाहिए।
यदि आप सिस्टम कार्यक्षमता को दस्तावेज करने के बारे में बात कर रहे हैं; हमारे संगठन में हमारी प्रशिक्षण टीम रिलीज के हिस्से के रूप में कार्यक्षमता दस्तावेज करती है। वे स्प्रिंट रिव्यू (डेमो) के दौरान (एक हितधारक के रूप में) व्यस्त हैं और फिर रिलीज से पहले प्रशिक्षण सामग्री तैयार करने के लिए नई कार्यक्षमता के साथ एक प्रशिक्षण वातावरण प्रदान किया।
यदि आप ट्रैक्टबिलिटी के लिए दस्तावेज प्रदान करने के बारे में बात कर रहे हैं, तो आपका बैकलॉग उचित प्रक्रिया के साथ & नियंत्रणों के साथ काम कर सकता है। इन विभिन्न मदों की
हर एक योजना और जानबूझकर प्रक्रिया के विकास लेता प्रभावी ढंग से काम करते हैं और टीम की जरूरतों को पूरा करने के लिए। हमने इन वस्तुओं में से प्रत्येक को हमारे पूर्वदर्शी में शामिल किया है क्योंकि एक समस्या की पहचान की गई थी और फिर समय के साथ हमारी प्रक्रियाओं को विकसित किया गया था।
यह सवाल इसलिए है क्योंकि यह इस साइट के लिए दायरे के भीतर नहीं है, के रूप में के रूप में परिभाषित विषय से हटकर है (// stackoverflow.com/help/on-topic) यह भी देखें [किन विषयों मैं यहाँ के बारे में पूछ सकते हैं?]: [क्या प्रश्नों के प्रकारों से मुझे पूछने से बचना चाहिए?] (// stackoverflow.com/help/dont-ask) आप [अन्य स्टैक एक्सचेंज साइट] (// stackexchange.com/sites#name) पर पूछने में सक्षम हो सकते हैं, उदाहरण के लिए [ pm.se] या [softwareengineering.se]। किसी भी साइट पर किसी प्रश्न को पोस्ट करने का इरादा रखने के लिए सहायता केंद्र में विषय-वस्तु पृष्ठ को पढ़ना सुनिश्चित करें। – Makyen