मैं जल्दी और कुशलता से एक कार्यात्मक विनिर्देश कैसे लिख सकता हूं


17

तो मैं सिर्फ जोएल द्वारा चश्मे यहाँ पर कुछ शानदार लेख पढ़ा । (2000 में लिखा गया था !!) मैंने सभी 4 भागों को पढ़ा, लेकिन मैं अपने चश्मे को लिखने के लिए कुछ पद्धतिगत तरीकों की तलाश कर रहा हूं

मैं अकेला अकेला देव हूं, जो एक बहुत अच्छी तरह से ज्ञात वित्त कंपनी के लिए इस जटिल एप्लिकेशन (या ऐप्स के परिवार) पर काम कर रहा है।

मैंने कभी भी इसे गंभीर नहीं बनाया है, मैंने एक बुरी कल्पना, कुछ प्रकार के अवलोकन जैसे कुछ लिखना शुरू कर दिया है, और इसने मेरा बहुत समय बर्बाद किया है।

मैंने अपने मुवक्किल के लिए 3 मॉकअप-थोड़े-से भी किए हैं, इसलिए मुझे अच्छी समझ है कि वे क्या चाहते हैं। इसके अलावा एक पूर्वावलोकन (सबसे बुनियादी वर्कफ़्लो के साथ एक थ्रो वर्किंग ऐप) जारी किया, और मैंने केवल बहुत ही कोर / बेस सिस्टम में से कुछ लिखा और परीक्षण किया है।

मुझे लगता है कि मैं अब तक जो गलती कर रहा हूं वह एक विस्तृत कल्पना नहीं लिख रहा है, इसलिए मैं अब इसे प्राप्त कर रहा हूं।

तो पूरी बात शामिल है

  • एक एमवीसी वेबसाइट (प्रवेश और डेटा देखने के लिए)
  • 2 सिल्वरलाइट मॉड्यूल (2 विशिष्ट कार्यों के लिए)
  • 1 डेस्कटॉप अनुप्रयोग

मैं समय पर पूरी तरह से कम हूं, संसाधनों और इसे जल्दी से पूरा करने की आवश्यकता है, साथ ही, यह सुनिश्चित करने की आवश्यकता है कि ये लोग इसे समान रूप से त्वरित और दर्द रहित पढ़ें।

  • तो मैं इसके बारे में कैसे जाना है, मैं किसी भी सुझाव, किसी भी वास्तविक दुनिया सामान के लिए देख रहा हूँ , आप लोग आमतौर पर कैसे करते हैं?
  • क्या आप हर डायलॉग / फॉर्म / पेज का नकली स्क्रीन बनाते हैं?

मैं एक डमी ASP.NET वेब फॉर्म प्रोजेक्ट बनाने की सोच रहा हूं, फिर फ़ोल्डरों में HTML फाइलों को भरना और इसे मेरी MVC URL संरचना की तरह बनाना।

फिर वेबसाइट के लिए एक सेक्शन में एक सेक्शन होना और एक स्क्रीनरी के साथ मुझे मिलने वाले हर URL के लिए एक पेज लिखना।

अपने जीत फॉर्म ऐप के लिए, मैंने कुछ हद तक एक डेमो विन फॉर्म प्रोजेक्ट बनाया है, तो क्या मैं एक संवाद या संरचना में सब कुछ डालूंगा, जैसा कि मैं वास्तविक ऐप में करूंगा और फिर स्क्रीन शॉट होगा?


इस प्रश्न में कुछ पृष्ठभूमि के लिए। मैं हमेशा एक पागल कूद-टू-कोड थोड़े आदमी रहा हूं, जिसने ठीक काम किया है, लेकिन मैं जिस ऐप पर काम कर रहा हूं, वह केवल जटिल नहीं है, यह बहुत प्रतिष्ठित और बड़ी कंपनी के लिए है और मुझे इसे प्राप्त करना है सही!

(और यह अब तक अच्छा चल रहा है, आज मैंने पूर्वावलोकन संस्करण का एक डेमो दिया जिसे बहुत से लोगों ने पसंद किया !! = D) !!

यदि मुझे प्रारंभिक डिज़ाइन सही मिलता है तो मेरा इस कंपनी के साथ एक शानदार व्यवसाय भी होगा, नई "भयानक" सुविधाओं के बारे में पहले से ही कई सोच हैं जो वे भुगतान करने के लिए तैयार हैं।


क्या यह आपके लिए है? क्या क्लाइंट ने इसका अनुरोध किया था? क्या आप अधिक डेवलपर्स से टीम में शामिल होने की उम्मीद कर रहे हैं?
जेएफओ

इसका मुख्य रूप से मेरे विकास में सहायता करना है। हर अब और फिर मुझे यादृच्छिक वित्त प्राप्त लोग बताते हैं कि "ओह हमे xxx या yyy करना चाहिए" जब हम पहले से ही इसकी चर्चा करते हैं, तो कभी-कभी कुछ बैठकों में लोग बस यादृच्छिक विशेषताओं का सुझाव देते हैं, सबसे खराब हिस्सा है, मेरे पास कभी भी उचित तरीका नहीं है अतिरिक्त शुल्क के लिए अतिरिक्त सुविधाओं को जोड़ना क्योंकि मेरी तथाकथित कल्पना पहले सिर्फ एक सारांश के अलावा कुछ नहीं थी! मूल रूप से मुझे सबसे अधिक समस्या है जोएल स्पोल्स्की ने अपने लेख में उल्लेख किया है जब आप एक युक्ति नहीं लिखते हैं।
गिदोन g

जवाबों:


22

क्या आपने लेख या उसके नमूना विनिर्देश के भाग 2 को पढ़ा ? विनिर्देशन लिखते समय वे कुछ महत्वपूर्ण सिद्धांतों को अपनाते हैं।

  • ओवरडिजाइन न करें। युक्ति लिखने का उद्देश्य आपको महत्वपूर्ण चीजों के बारे में सोचने के लिए मजबूर करना है जैसे कि एक त्रुटि होने पर क्या होता है, और आप उपयोगकर्ता से सिस्टम के साथ बातचीत करने की अपेक्षा कैसे करते हैं। आपको कुछ हासिल करने के लिए अनौपचारिक विवरण में जाने की ज़रूरत नहीं है। आपको विवरण की आवश्यकता है, हालांकि।
  • यह संचार के बारे में है। कल्पना का उद्देश्य एक सामान्य समझौते पर आना है कि क्या किया जाना चाहिए। यह एक लोहे का दस्तावेज नहीं है जिसे कानून के बल की आवश्यकता होती है। यह आपके ग्राहक को बेहतर ढंग से समझने में आपकी मदद करने का एक उपकरण है, और आपके ग्राहक को यह समझने में बेहतर है कि आप उनके लिए क्या करना चाहते हैं।

सबसे अच्छी सलाह यह है कि आप पर्याप्त रूप से लिखें ताकि आपको यह स्पष्ट हो कि आपको क्या करने की आवश्यकता है। यदि आपके पास खुले प्रश्न हैं, तो उन्हें कल्पना में दस्तावेज दें और अपने ग्राहक से उत्तर प्राप्त करें। एक बार जब आप पर्याप्त रूप से समझते हैं कि क्या रोकना आवश्यक है ।

यदि आप सावधान नहीं हैं, तो दस्तावेज़ स्वयं का जीवन लेगा। इसका एक उद्देश्य होना चाहिए, उस दस्तावेज़ में कुछ भी न जोड़ें जो उस उद्देश्य के लिए उपयुक्त नहीं है। इसे बनाए रखना आसान होना चाहिए। यदि आपके पास अपने पूरे विस्तृत वर्ग के आरेख हैं, तो अन्य विवरणों के साथ जो वास्तव में एक इकाई परीक्षण में हैं, आप या तो दस्तावेज़ को छोड़ देंगे क्योंकि रखरखाव बहुत अधिक है, या आपको परियोजना पूरी नहीं होगी।


लेखन के बारे में

लोगों के लिए लिखना कठिन है । वास्तव में, लेखन के बारे में दो सबसे कठिन चीजें यह जानना चाहती हैं कि कैसे शुरू करें , और यह जानना कि कब रोकना है । शुरुआत में आपको बस कुछ करना होगा। इन दो सबसे कठिन पहलुओं से निपटने के लिए मेरी सलाह है:

  • अपने दर्शकों को जानें। युक्ति पढ़ने वाला कौन है? अगर यह सिर्फ आप और ग्राहक हैं, तो आप इसे लिख रहे हैं। यदि आपके पास परीक्षण के लिए कोई जिम्मेदार है, तो आपके पास उनके लिए भी कुछ नोट होंगे।
  • सर्वोच्च प्राथमिकता वाली चीज़ से शुरू करें। जबकि प्रमाणीकरण महत्वपूर्ण है, लॉगिन स्क्रीन संभवतः सबसे अच्छा समझा जाने वाला टुकड़ा है जिसे ज्यादातर लोगों को लिखना है। इसके बजाय उस सुविधा पर ध्यान दें, जिसकी आपके उपयोगकर्ताओं को सबसे अधिक आवश्यकता है। आप जानते हैं, वह हिस्सा जो उन्हें पैसा बनाता है और वह संपूर्ण कारण है जिसके लिए उन्हें सॉफ्टवेयर की आवश्यकता होती है।
  • प्रश्न आते ही विवरण भरें और आपको उत्तर मिलें। यदि आवश्यक हो तो क्लाइंट नैपकिन ड्रॉइंग के साथ चीजों को तब तक सरल रखें जब तक कि ग्राहक व्यवस्था से खुश न हो जाए। यह जानना महत्वपूर्ण है कि कौन सी जानकारी शामिल है और वे इसका उपयोग कैसे करेंगे।
  • अधिक जोड़ने पर रोकें मूल्य नहीं जोड़ता है। कुछ विवरण हैं जो आप एक युक्ति में नहीं चाहते हैं। आपको यह जानना होगा कि आपके पास सही चीज़ कब है। आपको यह जानने की आवश्यकता नहीं है कि "अल्बाकर्क" नामक एक विधि के अंदर एक चर है। यह स्रोत कोड है, विनिर्देशन सामान नहीं।

आपके उत्तर के लिए +1 धन्यवाद। हां। मैंने जोल्स लेख के सभी 4 भागों को पढ़ा। पूरी स्क्रीनिंग प्रक्रिया के बारे में क्या मैं पहले डमी (सादा दिखने वाले) पेज और फॉर्म बनाऊंगा? ताकि मुझे पता चले कि मुझे क्या लिखना है? या मैं लिखना शुरू करूँ?
गिदोन

आप जो जानते हैं, उससे शुरू करें। इसे सरल रखें ताकि आप इसे सुंदर बनाने के लिए तैयार न हों। यदि आप उस सड़क से नीचे जाते हैं (आपके पास समय नहीं है) तो आपको किसी और की सहायता की आवश्यकता है। जबकि सुंदर चश्मा पचाने में आसान होते हैं, आपको आगे बहुत काम मिला है।
बेरिन लोरिट्श
हमारी साइट का प्रयोग करके, आप स्वीकार करते हैं कि आपने हमारी Cookie Policy और निजता नीति को पढ़ और समझा लिया है।
Licensed under cc by-sa 3.0 with attribution required.