मुझे अपनी विशिष्टताओं को किस व्याकरणिक काल में लिखना चाहिए?


21

वर्तमान में हम दो कॉलम प्रारूप में कार्यात्मक और तकनीकी विनिर्देश लिख रहे हैं; सारांश वाक्य और तकनीकी विवरण। विवरण अक्सर चित्र, लेआउट डिजाइन ect के साथ एक परिशिष्ट का उल्लेख करते हैं।

हालाँकि मैं इसे लिखने में कितना तनाव झेल रहा हूँ:

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

आगे भ्रम को जोड़ने के लिए यह विनिर्देश उन लोगों द्वारा पढ़ा जा सकता है जिनके पास पहली भाषा के रूप में अंग्रेजी नहीं है।

जवाबों:


12

हमें अपने काम के अंतिम स्थान पर बहुत कुछ मिला है।

उत्पाद प्रबंधकों ने वर्तमान काल का उपयोग करने के लिए चुना है कि क्या किया जाना चाहिए , जैसे:

उपयोगकर्ता एक आदेश भेजता है। सिस्टम एक पुष्टिकरण संदेश भेजता है।

दुर्भाग्य से पूर्व शर्त का वर्णन भी वर्तमान काल में किया गया था, जैसे:

उपयोगकर्ता खरीदारी की टोकरी में एक आइटम डालता है और मात्रा निर्दिष्ट करता है।

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


इसलिए:

  • जो पहले से मौजूद है, उसके लिए वर्तमान काल का उपयोग करें

  • क्या किया जाना चाहिए के लिए एक भविष्य काल का उपयोग करें। दुनिया को "चाहिए", "चाहिए", "करेंगे"।


याद करने के लिए महत्वपूर्ण कदम कल्पना फिर से है। भविष्य में होने वाले वर्डिंग को अद्यतन करने के लिए सुनिश्चित करें जब यह हो जाता है।
बेन एल

@ बनल: नहीं, यह गलत है। तनाव का उपयोग सही कार्यान्वयन प्रदान करने के लिए किया जाता है, न कि कार्यान्वयन की स्थिति को इंगित करने के लिए। यहां, भविष्य के तनाव का उपयोग भविष्य के अनुप्रयोग राज्य को इंगित करने के लिए किया जाता है, भविष्य के कार्यान्वयन राज्य के लिए नहीं। एक तरफ के रूप में, यह ध्यान देने योग्य है कि यहां की वकालत का उपयोग अधिकांश आरएफसी द्वारा भी किया जाता है। शर्तों की चर्चा के लिए RFC 2119 देखें / चाहिए / चाहिए (नहीं), चाहिए / अनुशंसित (नहीं), और हो सकता है / वैकल्पिक।
ब्रायन

5

वर्तमान काल मुझे अच्छा लगता है।

  1. पूर्वानुक्रम: फू राज्य X में है
  2. ऑपरेशन: यह और ऐसा होता है
  3. पोस्टकंडिशन: फू राज्य वाई में है

वे सभी वर्तमान काल में हैं।

या अगर यह "परियोजना की स्थिति" है

  1. संस्करण 10: में ए, बी, सी और डी की सुविधा है

  2. संस्करण 10.1: ए में सुधार शामिल है। बी में बग 1049 को ठीक करता है। नई सुविधा ई जोड़ता है।


3

आप जानना चाह सकते हैं कि RFC लिखने का अभ्यास क्या है।

यह RFC 2119 है: RFC में उपयोग के लिए मुख्य शब्द आवश्यकता के स्तर को इंगित करता है


3
यह पूछे गए प्रश्न का उत्तर कैसे देता है?
gnat

1
इसके अलावा, यह एक लिंक-केवल उत्तर है।
Kromster का कहना है कि


1

जब मैं सॉफ़्टवेयर के लिए डिज़ाइन बनाता हूं तो मैं वर्तमान तनाव का पक्ष लेता हूं, भले ही मैं सॉफ़्टवेयर के मौजूद होने से पहले डिज़ाइन बनाता हूं। डिज़ाइन से एक सॉफ़्टवेयर एप्लिकेशन लागू होने के बाद भी, डिज़ाइन अभी भी प्रासंगिक और महत्वपूर्ण दस्तावेज़ है। यह काफी संभव है कि सॉफ़्टवेयर के लागू होने से पहले एक डिज़ाइन दस्तावेज़ अधिक समय तक प्रासंगिक रह सकता है।

हमारी साइट का प्रयोग करके, आप स्वीकार करते हैं कि आपने हमारी Cookie Policy और निजता नीति को पढ़ और समझा लिया है।
Licensed under cc by-sa 3.0 with attribution required.