मैं जून, 2004 से एक तीन व्यक्ति के अनुबंध / परामर्श सेवा में भागीदार रहा हूं। हम प्रत्येक मुख्य रूप से अपने स्वयं के "खातों" का काम करते हैं, हालांकि हमें भागीदारों के बीच "फेलओवर" के लिए अनुमति देने के लिए एक दूसरे के लिए प्रलेखन बनाए रखने की आवश्यकता है। हमारे अधिकांश ग्राहकों के पास कुछ प्रकार के आंतरिक आईटी कर्मचारी हैं, जिनमें से कई दिन-प्रतिदिन के रखरखाव की कुछ राशि का प्रदर्शन करते हैं, और हमें उनसे प्रभावी ढंग से प्रलेखन संवाद करने की भी आवश्यकता है।
मेरे दो सहयोगियों को एक और फर्म में मेरे तहत कर्मचारियों के रूप में काम करने का फायदा है (यदि आप इसे कॉल कर सकते हैं) तो, परिणामस्वरूप, वे दोनों मेरे विचारों को करने के तरीके से प्रेरित थे। ग्राहकों के विन्यास के बीच सख्त स्थिरता (जहां चीजें, स्पष्ट रूप से, हो सकती हैं) एक भगवान हैं। जाहिर है, उत्पादों में बदलाव होता है, इसलिए हम नए उत्पादों / संस्करणों, आदि पर चर्चा करने के लिए कॉकस करते हैं, और हमारी तैनाती से पहले एक सुसंगत कॉन्फ़िगरेशन रणनीति पर निर्णय लेते हैं। यह एक बड़ी कंपनी के पैमाने पर नहीं होगा, लेकिन स्पष्ट रूप से, मैं इसे बग के बजाय एक विशेषता के रूप में देखता हूं। (मैं अपने कर्मचारी "इंजीनियरों" के साथ बड़ी "प्रबंधित सेवाओं" कंपनियों के बारे में शेख़ी करना शुरू नहीं करूँगा और एक-ऑफ़्स के लिए भयानक प्रवृत्ति, "समाधान", और ग्राहकों के बीच असंगतता ...> मुस्कान <)
मैं "खूंखार बाइंडर" के खिलाफ हिंसक हूं । मैंने आज तक कभी भी शारीरिक दस्तावेज नहीं देखे हैं । मुझे लगता है कि प्रलेखन की भौतिक प्रतियां बनाने में समय बिताना ग्राहक के पैसे की बर्बादी है। मैं बहुत समय बिताऊंगा ताकि वर्किंग रनिंग कॉन्फ़िगरेशन से "लाइव" डेटा के आधार पर प्रलेखन उत्पन्न किया जा सके।
एक उदाहरण के रूप में, मैं पूरी तरह से आईपी पते की जानकारी के स्प्रेडशीट को बनाए नहीं रखूंगा। यही डीएचसीपी और डीएनएस (बारीकियों के लिए नीचे देखें) हैं। अगर वे चीजें काम नहीं कर रही हैं तो हमें बड़ी समस्याएं हैं।
हमारे पास ग्राहक हैं, जैसे चीजों का अनुरोध करते हैं "एक दस्तावेज बनाएं जो हमारे सभी समूह नीति कॉन्फ़िगरेशन को दिखाता है" और मैंने अपनी एड़ी में खोदा है और इसे करने से इनकार कर दिया है। मेरा आवर्ती प्रति-प्रस्ताव (जो अब तक काम किया गया है) ग्राहक को प्रशासनिक उपकरणों से परिचित कराना है जो उन्हें "स्व-सेवा" या सॉफ्टवेयर का उपयोग करके "लाइव" ग्राहक-अनुकूल प्रलेखन ऑन-डिमांड उत्पन्न करने के लिए दे सकता है।
हम सादे अंग्रेजी में चीजों को वर्तनी के बारे में सावधानीपूर्वक करने के लिए वास्तव में कठिन प्रयास करते हैं। एक गैर-तकनीकी आईटी संपर्क, उदाहरण के लिए, कंप्यूटर की सक्रिय निर्देशिका समूह सदस्यता की समीक्षा कर सकता है और "सॉफ़्टवेयर - इंस्टॉल Microsoft Office 2010 Pro" और "समूह नीति - शिपिंग कियोस्क कंप्यूटर ऑटो-लॉगऑन" जैसी चीजें देख सकता है। यह बताने के लिए कोई दस्तावेज नहीं है कि उन चीजों का क्या मतलब है।
यहां कुछ "लाइव" डेटा का उपयोग किया गया है:
सभी आईपी एड्रेस आवंटन डीएचसीपी सर्वरों में संग्रहीत किया जाता है - इसमें सांख्यिकीय रूप से संबोधित डिवाइस भी शामिल हैं, (टिप्पणियों में इस तरह के रूप में भी)। मैक और आईपी पते को स्क्रिप्ट या मैन्युअल रूप से आसानी से उद्धृत किया जा सकता है और परिभाषा के अनुसार, डेटा को अप-टू-डेट होना चाहिए अगर यह उत्पादन में उपयोग किया जा रहा है।
सब कुछ DNS में एक नाम और PTR रिकॉर्ड मिलता है। अधिकांश होस्ट को HINFO रिकॉर्ड भी मिलता है। जिन चीज़ों के लिए वर्बोज़ विवरण की आवश्यकता होती है, उन्हें TXT रिकॉर्ड मिलता है।
सक्रिय रूप से कहीं भी "नोट्स" फ़ील्ड के संभावित और वर्बोज़ उपयोग - सक्रिय निर्देशिका, कंप्यूटर विवरण, साझा फ़ोल्डर विवरण आदि, हम सुरक्षा समूह के नाम जैसी चीज़ों के साथ भी क्रिया और स्पष्ट हैं।
नेटवर्क गियर कॉन्फ़िगरेशन में टिप्पणियाँ / टिप्पणी (ACL पर टिप्पणी, बंदरगाहों पर वर्णन, SNMP स्थान / संपर्क जानकारी, उदाहरण के लिए)।
टेक्स्ट फाइल्स, विकी आदि जैसी चीजों में फ्री-फॉर्म सूचना भंडारण के विचार पर मैं काफी नकारात्मक हूं। अच्छी खोज के लिए स्ट्रक्चर बनाता है। जब भी मुझे काम करने के लिए एक संरचित भंडारण तंत्र मिल सकता है (भले ही इसका मतलब है कि मुझे इसे क्वेरी करने के लिए सॉफ़्टवेयर लिखना होगा) मैं इसे पसंद करता हूं। टिप्पणियाँ जो मैं कॉन्फ़िगरेशन फ़ाइलों, डेटाबेसों आदि से बाहर कर सकता हूं, मैन्युअल रूप से तैयार किए गए दस्तावेज़ों के खिलाफ डालते समय हमेशा मुझे जीतते हैं जो लगभग तुरंत गिर जाएंगे।
जब हमें "फ्री-फॉर्म" जानकारी संग्रहीत करनी होती है तो हम अपने स्वयं के SVN रिपॉजिटरी का उपयोग करते हैं। इसमें सभी विभिन्न बिट्स और स्थिर दस्तावेज हैं जो हमने ग्राहक द्वारा दायर किए गए वर्षों में बनाए हैं। हम 2004 से इसके लिए SVN का उपयोग कर रहे हैं और इसने हमारे लिए एक सहयोग उपकरण के रूप में बहुत अच्छा काम किया है। हम डेटाबेस स्कीमा, sysadmin स्क्रिप्ट, ग्रुप पॉलिसी ऑब्जेक्ट बैकअप आदि का संस्करण देते हैं। मैं संस्करण नियंत्रण में सब कुछ जांचने की कोशिश करता हूं।
फाइलसिस्टम-आधारित इंडेक्सिंग टूल के साथ मेरे चेकआउट को खोजना बहुत आसान है। मुझे पता है कि हममें से प्रत्येक के पास किसी भी समय स्थानीय स्तर पर उपलब्ध रिपॉजिटरी की कम से कम एक पूर्ण प्रति है। हमने SSL पर प्रमाणित WebDAV के माध्यम से रिपॉजिटरी को सुलभ बनाया है, जब हमें पूरी तरह से वहाँ संग्रहीत डेटा और केवल ब्राउज़र की पहुँच प्राप्त करनी है।
हमें ऐसा करने के लिए कभी नहीं कहा गया है, लेकिन हम एसवीएन सर्वर पर एक खाता बनाने के लिए खुश होंगे ताकि ग्राहक को अपनी फ़ाइलों की जांच करने और बातचीत करने की अनुमति मिल सके (यदि उनके पास आंतरिक संसाधन है जो बहुत इच्छुक है )। हम सभी स्टैटिक कस्टमर डॉक्यूमेंटेशन (सॉफ्टवेयर लाइसेंस डॉक्यूमेंटेशन, परचेज रेकॉर्ड्स आदि) को स्टोर करने के लिए एक मानकीकृत प्रारूप का उपयोग करते हैं, जो कि बहुत ही आत्म-व्याख्यात्मक है।
एसवीएन रिपॉजिटरी के साथ, हम अपने ईमेल को भी स्वयं होस्ट करते हैं। आने वाले / बाहर जाने वाले सभी ईमेल को संग्रहीत किया गया है क्योंकि कंपनी के डोमेन ने ईमेल प्राप्त करना शुरू कर दिया है। यह BSMTP के रूप में उपलब्ध है, संदर्भ के लिए साझेदारों (और, व्यक्तिगत रूप से, मैंने इसे अमूल्य पाया है)। स्थिति कभी सामने नहीं आई है, लेकिन मुझे पता है कि अगर वे कभी पूछते हैं, तो हम किसी भी पत्राचार के लॉग के लिए ग्राहक पहुंच देने में खुशी होगी। साझेदारों के बीच आंतरिक संवाद कायम करना अधिक कठिन होगा क्योंकि हम एक ही संदेश में कई ग्राहकों को अच्छी तरह से संदर्भित कर सकते हैं। (हमें शायद इस बारे में बेहतर होना चाहिए लेकिन हम नहीं रहे हैं।)
पासवर्ड हमारी प्रक्रिया में एक प्रमुख "मस्सा" हैं। हम प्रत्येक ग्राहक के लिए व्यक्तिगत "पासवर्ड सेफ" रिपॉजिटरी (अद्वितीय संयोजनों के साथ) का उपयोग कर रहे हैं ताकि सुरक्षित फ़ाइल को ग्राहक के साथ साझा किया जा सके। हम सभी सुरक्षित फ़ाइलों के लिए मास्टर पासवर्ड एक अन्य सुरक्षित फ़ाइल में रखते हैं, जिसमें केवल भागीदारों के लिए जाना जाता है। इस हिस्से को वास्तव में कुछ काम की जरूरत है। मुझे लगता है कि हम प्रत्येक ग्राहक को एक वास्तविक बहु-उपयोगकर्ता पासवर्ड वॉल्ट एप्लिकेशन (ऑडिट ट्रेल आदि के साथ) का उपयोग करके ऑन-साइट क्रेडेंशियल वॉल्ट होस्ट करना चाहते हैं, लेकिन हम उस विचार को लगभग 10 वर्षों से समुद्र तट के नीचे मार रहे हैं। ।
हमारे समय पर नज़र रखने के रिकॉर्ड सावधानीपूर्वक विस्तृत हैं और जो भी इलेक्ट्रॉनिक प्रारूप में ग्राहक को प्रदान किए जाते हैं, वे चाहते हैं (जो इस बिंदु तक, एएससीआईआई पाठ और पीडीएफ हैं)। ग्राहकों को प्रत्येक बिल योग्य घटना पर शुरू / बंद समय मिलता है, और काम का एक वर्बोज़ विवरण दिया जाता है। हम इन सेवा नोटों को आंतरिक रूप से बहुत मूल्यवान मानते हैं क्योंकि वे हमें साझेदारों की ग्राहक साइटों में होने वाली गति को बनाए रखने की अनुमति देते हैं। एक समस्या की स्थिति में ये रिकॉर्ड हमें उन सभी पूर्व मुद्दों और संकल्पों के बारे में ज्ञान देते हैं, जो हमने वर्षों से झेले हैं। मुझे यह कहने में कोई शर्म नहीं है कि मैंने एक ग्राहक के लिए उन मुद्दों को हल किया है जो नोटों को खोजने से पहले मैं दूसरे ग्राहक वर्षों के लिए लिखना भूल गया था।
एक त्वरित और सावधानी से फिर से: उत्पादन प्रलेखन: मेरी "पुरानी नौकरी" पर (किसी और के लिए सालों पहले काम करना) कंपनी एक गैर-भुगतान करने वाले ग्राहक के खिलाफ कानूनी कार्रवाई में जुट गई। हमने गैर-भुगतान वाले ग्राहक से एक काउंटर-सूट के व्यापार-अंत पर समाप्त किया। हमारे आंतरिक रिकॉर्ड और ईमेल फिर से: ग्राहक को अदालत के सामने प्रस्तुत किया गया और नंगे रखा गया। उस अनुभव ने मुझे एक निश्चित माध्यम में कुछ भी संग्रहीत नहीं करने के बारे में बहुत कुछ सिखाया जो आप सार्वजनिक नहीं करना चाहते हैं।
मैंने इस ग्राहक के साथ मेरी कुंठा के बारे में और मेरी कंपनी में कुछ अन्य "इंजीनियरों" के साथ उनके बारे में कुछ (erm) पसंद शब्द और वाक्यांशों के साथ कुछ ईमेल लिखे थे । खुली अदालत में इन चीजों के बारे में जिरह करने के बाद कुछ ऐसा नहीं हुआ जिसका मैंने बिल्कुल आनंद लिया।
जब हमने अपना वर्तमान व्यवसाय शुरू किया तो भागीदारों ने सहमति व्यक्त की कि सभी निश्चित रिकॉर्ड (ईमेल, पाठ संदेश, ध्वनि मेल, SVN रिपॉजिटरी में फाइलें, समय ट्रैकर में काम रिकॉर्ड आदि) को "ग्राहक-सामना" सभी समय माना जाएगा - यहां तक कि यदि वे कभी भी ग्राहकों के हाथों में समाप्त होने का इरादा नहीं रखते थे। यह करना कठिन है और बहुत अधिक अनुशासन लेता है लेकिन मुझे लगता है कि यह इसके लायक है। हम निश्चित रूप से अपने ग्राहकों को व्यावसायिकता की एक हवा पेश करना चाहते हैं, और इसे जीने का तरीका है। मैं निश्चित रूप से कभी भी शर्मिंदा नहीं होऊंगा जैसा कि मैं फिर से उस कठघरे में था।