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