आप अपने काम, प्रक्रियाओं और पर्यावरण का दस्तावेजीकरण कैसे कर रहे हैं?


48

क्या आप विकि प्रारूप का उपयोग कर रहे हैं? यदि हां, तो कौन सा उत्पाद? (मीडियाविकि, संगम, शेयरपॉइंट आदि)

क्या आपने ज्ञान का आधार बनाया है? (समस्या / समाधान उन्मुख लघु दस्तावेज।)

दस्तावेज़ बनाने के साथ आपको क्या चुनौतियाँ मिलती हैं, इसलिए जब आप छुट्टी पर होते हैं तो आपको कॉल नहीं आती है?

मेरे लिए, मुझे लगता है कि अक्सर एक निश्चित मात्रा में संगठनात्मक "जड़ता" होती है, जिसमें प्रलेखन किया जाता है। यह एक अलग तरह का व्यक्ति प्रतीत होता है जो एक कार्य कर सकता है, तो सोचें कि उन्होंने कैसे कार्य किया और इसका वर्णन किया ताकि कोई दूसरा व्यक्ति ऐसा कर सके - आप को "जाओ मेटा" करने के लिए तरह तरह के बल और हर कोई ऐसा करने में सहज नहीं है।

अपडेट करें

अब तक के उत्तर शामिल हैं

  • संगम
  • Flexwiki
  • FogBugz
  • मीडियाविकि (प्लगइक के रूप में प्लगइन्स के साथ)
  • शेयर बिंदु
  • TWiki
  • वर्ड / एक्सेल / विज़ियो डॉक्स
  • दस्तावेज लिखे

संपादित करें: क्या आप अपने निगरानी प्रणाली के साथ अपने नेटवर्क का दस्तावेजीकरण नहीं कर रहे हैं? Nagios ने हमेशा आपके नेटवर्क की संरचना को दर्शाने के लिए माता-पिता के निर्देश के उपयोग को प्रोत्साहित किया है , और नोट्स_url निर्देश को आपको एक विकी या अन्य ब्राउज़र-आधारित दस्तावेज़ से लिंक करने की अनुमति देने के लिए डिज़ाइन किया गया है। तो यहाँ "प्रलेखन" निगरानी प्रणाली के "जीवित दस्तावेज़" और एक विकी में अधिक विस्तृत, ऑफ़लाइन प्रलेखन के बीच विभाजित है। चूंकि मैं नागिओस को घूरते हुए बहुत समय बिताता हूं, इसलिए इसे यथासंभव जानकारीपूर्ण बनाने में प्रयास करने का अर्थ है।


आपके सवाल ने सिर्फ slashdot Tech.slashdot.org/article.pl?sid=09/05/25/2154237
यूज़रनेम

हेहे :) काश मैं किसी तरह इस सवाल को समाप्त कर सकता, शायद बीटा खत्म होने का इंतजार करता ...
Cawflands

साइडबार में "संबंधित" अनुभाग देखें - serverfault.com/questions/3970/… हो सकता है कि आप क्या देख रहे हों
ओलाफ

मॉनिटरिंग सिस्टम ऐसे Nagios आपको बताता है कि वर्तमान में आपका नेटवर्क / सिस्टम कैसा दिखता है। वे आमतौर पर आपको यह नहीं बताते हैं कि नेटवर्क और सिस्टम सेटअप क्यों हैं जिस तरह से वे हैं।
डेविड

जवाबों:


8

टूलींग पर टिप्पणी।

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

जुड़ा होना एक गंभीर समस्या है यदि आप या तो ऑफ़लाइन या ऑनसाइट हैं (जाहिर है कि आप सुरक्षित एसएसएल एट अल के साथ ऑनसाइट को कम कर सकते हैं।)

हमारी वर्तमान प्रलेखन प्रक्रिया है:

  • स्थिर HTML जनरेटर
  • मार्कडाउन सिंटैक्स
  • वितरित संस्करण प्रणाली

हमारे पास प्रलेखन के लिए एक 'औपचारिक' लेआउट है और यह मेनू के लिए संरचना प्रदान करता है (और दृश्य स्टाइल के लिए संबंधित सीएसएस आदि)

स्टेटिक HTML जेनरेटर

हम एक घर में स्थैतिक HTML जनरेटर का उपयोग करते हैं जो क्यूबिक्टेम और कई अन्य उपकरणों पर आधारित होता है : pyolution , docutils

उत्पन्न पृष्ठ (नहीं?) स्पष्ट रूप से बदसूरत दिख रहे हैं, जैसा कि हम में से अधिकांश / हमारे sysadmins / प्रोग्रामर जानते हैं कि सौंदर्य की दृष्टि से सुंदर क्या है, लेकिन इस तरह के निर्माण में समन्वय की कुल कमी है।

लेकिन यह आर्डर करता है / हम विन्यास फाइल, नमूना स्क्रिप्ट, पीडीएफ़ इत्यादि को शामिल करें, बिना html स्वरूपण के बारे में चिंता किए बिना इसे खराब करने या इसे डाउनलोड करने के लिए 'सर्वर' पर खोजने के बारे में चिंता करें।

यदि यह HTML नहीं है, तो बस इसे फ़ोल्डर में छोड़ दें और इसमें एक यूआरएल लिंक जोड़ें।

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

हमारे सभी मशीनों में मूल html सेवारत के लिए ग्रंट है, और हमारे लिए पर्याप्त रूप से काम करता है।

मार्क सिंटैक्स।

हम markdown, Textish और या का एक bastardised संस्करण का उपयोग reStructuredTEXT एचटीएमएल के बारे में चिंता किए बिना हमारे 'रचनात्मक' रस प्रलेखन लिख जाने के लिए।

इसका मतलब यह भी है कि हर किसी को अपने पसंदीदा संपादक (मैं विंडोज और * निक्स पर सिंटिला का उपयोग करता हूं) का उपयोग करता हूं, जबकि अन्य यहां vi / vim का उपयोग करते हैं।

वितरित संस्करण प्रणाली।

हम उपयोगकर्ताओं के बीच प्रलेखन को 'वितरित' करने के लिए Git का उपयोग करते हैं । ओह, और हम इसका उपयोग संस्करण क्षमता भी कर रहे हैं।

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

निजी तौर पर, मुझे ब्लॉग को अपडेट करने के लिए सर्वर से बंधे होने से नफरत है, अकेले विकी की। गिट हमारे लिए अच्छा काम करता है।

वर्कफ़्लो पर टिप्पणी करना

विकी को ज्ञान प्रसार / संहिताबद्धता के लिए "फैशन" लगता है, लेकिन जैसा कि अन्यत्र टिप्पणी की गई है कि सभी प्रक्रियाओं को बनाए रखना मुश्किल हो जाता है, और ऐसे उपकरणों का मिश्रण खोजना जो आपकी टीमों की जरूरतों का सबसे अच्छा समर्थन करते हैं और टिकाऊ होते हैं, समय लगेगा।

बेहतर समाधान बस खोजा जा रहा है और अनिवार्य नहीं है।


1
मैं git के शीर्ष पर ikiwiki का उपयोग करता हूं । मुझे
मार्कडाउन

7

हमने DokuWiki का उपयोग करना शुरू कर दिया है जहां मैं काम करता हूं।

Dokuwiki की वेबसाइट से:

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

मुझे Dokuwiki को लागू करने में सबसे आसान लगा क्योंकि इसके लिए किसी डेटाबेस की आवश्यकता नहीं है, और इसे सेटअप करना आसान था। ऐड-इन मॉड्यूल भी थे जो मेरे मौजूदा सक्रिय निर्देशिका खाता लॉगऑन का उपयोग करने में सक्षम थे, बल्कि सभी के लिए खाते बनाने के लिए सक्षम थे, जो कि अन्य विकी सिस्टमों में से एक से अधिक एक विशाल प्लस था। इसका विशिष्ट संस्करण नियंत्रण भी है, जहां आप देख सकते हैं कि कौन क्या पोस्ट करता है, और यह आवश्यक होने पर पिछले संस्करण को आसानी से रोल करने की क्षमता रखता है। इनमें एक अनुकूलन योग्य होम पेज भी शामिल होता है, जहाँ आपके पर्यावरण के लिए जो भी प्रकार की सामग्री सबसे उपयुक्त होती है, उसे आप आसानी से बदल सकते हैं।


6

डॉक्यू विकी या शेयर पॉइंट अन्य चीजों के लिए जो एक चार्ट में फिट होते हैं।

आपको विकी पर पोस्ट करने के लिए बहुत तेजी से उपयोग किया जाता है और वाक्यविन्यास वास्तव में इतना जटिल नहीं है। जानकारी को व्यवस्थित करना और बाद में किसी और के द्वारा इसे ढूंढना आसान बनाना बहुत आसान है।

मैं स्पष्ट स्पष्टीकरण (जेपीईजी के रूप में निर्यात) के लिए रेखांकन बनाने के लिए विज़ियो का उपयोग करता हूं।


6

हम एक विकी का उपयोग कर रहे हैं। वास्तव में, हम MediaWiki का उपयोग कर रहे हैं। मीडियाविकि के शीर्ष पर, हमारे पास सेमेटिक मीडियाविकि एक्सटेंशन स्थापित है, जो वास्तव में हमारे मीडियाविकि को कुछ टाइप किए गए डेटाबेस में बदल देता है जिसे हम श्रेणी, शीर्षक, सामग्री आदि के साथ क्वेरी कर सकते हैं।

उदाहरण के लिए, मान लें कि मैं क्लस्टर F के माध्यम से उस मार्ग के सभी नेटवर्क cnames को देखना चाहता हूं। मुझे केवल उस विशेष का उपयोग करने की आवश्यकता है: पृष्ठ से प्रश्न पूछें [[श्रेणी: cname]] [[गंतव्य :: क्लस्टर_फ]] ।। । और यह उन सभी पृष्ठों को वापस कर देगा जिन्हें cname के रूप में वर्गीकृत किया गया है, जिन्हें क्लस्टर_f के रूप में गंतव्य के साथ जोड़ा गया है।

हम कुछ सौ बहुत असमान ग्राहकों का समर्थन करते हैं, इसलिए उस दस्तावेज को एक केंद्रीय स्थान पर रखना (और इसे क्रॉस-लिंक किया हुआ है ताकि विशेष मामलों को दस्तावेज में बांधा जाए और पूरी तरह से बंधे रहें) एक बहुत बड़ी बात है। जाहिर है, हमारे प्रलेखन को बनाए रखने की जरूरत है, लेकिन आप रखरखाव के लिए एक 'माली' दृष्टिकोण का अधिक ले सकते हैं क्योंकि एक बड़े डेटासेट चालू रखने के लिए मीडियाविकि टूलकिट पहले से ही काफी परिपक्व है।


6

सही प्लगइन्स के साथ, Trac एक संयोजन टिकट और विकी सिस्टम बन सकता है। इससे आपके टिकटों को विकि लेखों से जोड़ना आसान है और इसके विपरीत।

मुझे पसंद आने वाले कुछ जोड़े:

  • निजी टिकट प्लगइन । Trac एक बगबेस के रूप में बनाया गया है जहाँ सभी टिकट और उनकी प्रतिक्रियाएँ सार्वजनिक हैं। यह एक आईटी टिकट प्रणाली के लिए उपयुक्त नहीं है, लेकिन यह प्लगइन इसे ठीक करता है।
  • Trac WYSIWYG प्लगइन । आइए इसका सामना करते हैं, ज्यादातर लोग आपको खुश करने के लिए विकिसिनटैक्स सीखने नहीं जा रहे हैं। इससे उन्हें टिकट और विकी पेज दोनों के लिए 'आपको जो दिखता है वही मिलता है।'

Trac के लिए कुछ और अनुकूलन हैं। अपनी पसंद के हिसाब से Trac सिस्टम को सेटअप और कस्टमाइज़ करना मुश्किल नहीं है!


1
+1 यह। इतना ही नहीं Trac का विकी डॉक्यूमेंटेशन के लिए रीडिंग और एडिटिंग को आसान बनाता है। कॉन्फ़िगरेशन वर्जनिंग के लिए इश्यू टिकटिंग और एसवीएन के साथ उपयोग किए जाने पर, आपके पास पूरे वर्कफ़्लो की निर्बाध दृश्यता होती है।
डैन कार्ली

5

अपने पिछले काम में मैंने ट्विकी का इस्तेमाल किया। इसने काफी अच्छा काम किया।

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

दोनों के संयोजन (और स्क्रिप्ट के लिए संस्करण नियंत्रण का उपयोग करके) ने चाल को काफी अच्छा किया।



5

संस्थागत ज्ञान

हमने दस्तावेजों के साथ शुरुआत की। फिर हमने उनमें से कुछ को शेयरपॉइंट पुस्तकालयों में संग्रहीत किया। फिर हाल ही में हम शेयरपॉइंट विकी में चले गए। मुझे चीजों को जल्दी से अपडेट करने में विकी का कम घर्षण वाला दृष्टिकोण पसंद है, हालांकि शेयरपॉइंट की विकी ने ग्राफिक्स समर्थन में वांछित होने के लिए कुछ चीजों को छोड़ दिया और टेबल जैसी चीजों के लिए समर्थन को प्रारूपित किया। यह पाठ के लिए ठीक है और अंतर्निहित संपादक कुछ बुनियादी HTML स्वरूपण और आदेशित / अनियोजित सूचियों की अनुमति देता है। शेयरपॉइंट के अन्य कम लागत वाले विकल्प हैं।

हमारे पास हमारी सहायता डेस्क सॉफ्टवेयर, नुमारा के ट्रैक-इट में हमारे समर्थन टिकटों के लिए एक अनौपचारिक ज्ञान का आधार है। यह सही नहीं है, लेकिन यह काम करता है।

स्टाफिंग का उपयोग करने के लिए संस्थागत ज्ञान प्राप्त करना

मैं आपके आकलन से सहमत हूं कि संस्थागत ज्ञान प्राप्त करना लड़ाई का केवल एक हिस्सा है। यदि आपके संगठन और लोगों को "पहले शोध, दूसरे से पूछें" का उपयोग नहीं किया जाता है, तो आप पाएंगे कि पुराना तरीका प्रबल है: हर कोई अभी भी उत्तर के लिए औपचारिक और अनौपचारिक गुरुओं को देखेगा, और कुछ लोगों के लिए यह पूछना हमेशा आसान होगा आप के बगल में व्यक्ति अपने दम पर खोज करने के लिए।

इससे निपटने के लिए कुछ परिवर्तन प्रबंधन शामिल होंगे; एक छोटी सी टीम से अधिक प्रभावित करने वाली सबसे सफल परिवर्तन पहल की तरह, यह प्रबंधकीय समर्थन और समर्थन करने में मदद करेगी। आपको वास्तव में दो दिशाओं में नया व्यवहार करना होगा; किसी को ज्ञान पर कब्जा करने की जरूरत है और लोगों को इसका उपयोग करने की आवश्यकता है। इससे भी कठिन यह है कि लोगों को उस डेटा को चालू रखने की भी आवश्यकता है।

बस कुछ विचार: शायद औपचारिक नीति के रूप में प्रोत्साहित करने की आवश्यकता होगी, जिसमें कहा गया है कि हल किए गए टिकट और मुद्दों को ज्ञान के आधार या विकी में दस्तावेज करने की आवश्यकता है, इससे पहले कि उन्हें बंद किया जा सके। इसके अलावा, सामान्य तौर पर पूछे जाने वाले ज्ञान के नेताओं को हमेशा अनुरोध पर जवाब नहीं देना चाहिए; उन्हें लोगों को विकियों की ओर संकेत करने की आवश्यकता है और उन्हें पहले वहां जांचने की आदत डालें। एक और बात उपयोगकर्ताओं को स्वयं-सहायता के लिए डेटा उपलब्ध कराने के लिए होगी ताकि समस्या को संभवतः हल किया जा सके, इससे पहले कि एक और वस्तु तकनीकी कर्मचारियों को हथकड़ी लगानी पड़े।

हमारे हेल्प डेस्क सिस्टम के लिए क्या अच्छा होगा कि स्टैकऑवरफ्लो और सर्वरफॉल्ट के समान एक सिस्टम हो: एक प्रश्न टाइप करते समय, खोज इंजन को समान आइटम मिलते हैं और उन्हें प्रदान करते हैं, इसलिए उपयोगकर्ता प्रश्न सबमिट करने से पहले भी उन्हें देख सकते हैं।


+1: जहां मैं काम करता हूं, यह संसाधनों का उपयोग करने के लिए कर्मचारियों को प्राप्त करने के साथ एक समान समस्या थी, विशेष रूप से, इसे देखने के लिए समस्या ट्रैकिंग प्रणाली का उपयोग किया गया था। मैंने उन लोगों को लेना शुरू कर दिया, जिन्हें अपनी आदत को बदलने के लिए मुझे अपनी मेज पर वापस जाने की आदत थी, पहले दो बार और उनके साथ एक नया बग टिकट भरना था। 2 महीने लग गए और अब हर कोई अपनी-अपनी बगिया में प्रवेश कर गया है और सभी को क्रम में ध्यान रखना है। एक समान दृष्टिकोण यहां उपयोगी हो सकता है (यानी [उनके साथ प्रणाली में प्रश्न में दस्तावेज़ के लिए देखो)
स्टीवन एवर्स

4

अपने अंतिम दो स्थानों पर मैंने एक काम लाइब्रेरी के साथ-साथ कुछ दस्तावेजों (जैसे DRPs और वन टाइम अपग्रेड प्लान) के साथ साझा किया, जिसमें Sharepoint's Wiki का उपयोग किया गया, जिसे आसानी से विकी दस्तावेज़ के रूप में नहीं बनाया जा सकता है। उन दस्तावेजों के विकी के भीतर से लिंक थे। विकी के इस क्षेत्र में कई फायदे हैं, क्योंकि बहुत से लोग इसे संपादित कर सकते हैं, संस्करण बनाना अंतर्निहित है, आसानी से खोजा जा सकता है और सुलभ आदि। जल्दी से नोट्स या विचारों को लिखने के लिए, मैं OneNote या व्हाइटबोर्ड का उपयोग करूंगा।

मैंने फोरम फॉर्मेट (लोटस नोट्स और एमएस शेयरपॉइंट दोनों) में पहले कुछ ज्ञान के आधार बनाए थे, लेकिन मुझे यह कहना होगा कि केवल एक निश्चित समस्या पहले से ही हल करने के लिए लोग शायद ही उन्हें देख रहे हों। इस तरह के समाधान को एक बहुत मजबूत और प्रभावी खोज इंजन के साथ दिन-एक से आना चाहिए।

यदि आप ऐसे दस्तावेज़ बनाना चाहते हैं, जिनका उपयोग छुट्टियों के दौरान किया जा सकता है, तो उन्हें लिखें जैसे कि आप अपने माता-पिता में से किसी एक को निर्देश देने का प्रयास कर रहे हों। यह 100% मूर्खतापूर्ण सबूत नहीं है, लेकिन कभी-कभी मदद करता है। निर्भर करता है कि कौन इसे पढ़ रहा है।


मैं मानता हूं कि इन उपकरणों के उपयोग के लिए अच्छी खोज बिल्कुल महत्वपूर्ण है। Sharepoint में सभ्य खोज प्राप्त करना हाल ही में एक सहयोगी द्वारा हासिल किया गया था, यह ठीक है लेकिन यह Google नहीं है।
Cawflands

4

शेयरपॉइंट अच्छा है।

यह खोज सुविधाओं में लगभग किसी भी प्रकार के दस्तावेज़ को अनुक्रमित करने की क्षमता है, जिससे खोज दस्तावेज़ को वास्तव में आसान बना दिया गया है।

यह कुछ टेम्प्लेटिंग भी कर सकता है जो कि आसान बना सकता है यदि उदाहरण के लिए आपके पास प्रत्येक सर्वर के लिए एक मानक जानकारी शीट है।

यह आपके लिए आपके दस्तावेज़ों का संस्करण भी दे सकता है ताकि आपके पास दस्तावेज़ परिवर्तनों का ऑडिट इतिहास हो।

इसके अलावा दस्तावेज़ पुस्तकालयों में निहित फ़ाइलों को वेब पर, आउटलुक में, या बॉक्स के ठीक बाहर एक बिना साझा किए साझा किया जा सकता है।


3

हमने कई वर्षों के लिए मीडियाविकि (fckeditor के साथ) का उपयोग किया है , हालांकि मुझे कहना होगा कि चित्र (यानी स्क्रीनशॉट) को संभालना आसान होगा। और खोज करने की क्षमता होने के लिए आवश्यक है - मुझे लगता है कि मीडियाविकि की खोज अक्सर पृष्ठों को याद करती है। शायद यह केवल बेहतर खोज करने के लिए सीखने का विषय है (जो आपके काम करने के लिए दूसरों के लिए एक सरल तरीका होने के उद्देश्य को पराजित करता है)

अभी हम MS Sharepoint पर सब कुछ आगे बढ़ने के बारे में बात कर रहे हैं , हालाँकि उनकी विकि पर ख़ुशी नहीं है। मुझे लगता है कि शेयरपॉइंट एक तरह से पूर्ण दस्तावेज़ खोज करने में सक्षम है जो विकी के कुछ लाभों को नकारता है, इसलिए हम देखेंगे कि यह कहाँ जाता है।

(हालांकि हमारे सभी मौजूदा प्रलेखन पोर्टिंग की प्रक्रिया के लिए आगे नहीं देख रहे हैं :))


1
मैंने पढ़ा है कि खोज को बेहतर बनाने के लिए स्फिंक्स एक MW स्थापना के लिए एक योग्य अतिरिक्त है।
Cawflands

3

हम एक विकी का उपयोग कर रहे हैं। निश्चित रूप से वाक्यविन्यास का उपयोग करने के लिए थोड़ा सा समय लगता है, लेकिन हम जो उपयोग कर रहे हैं (ट्विकी) उसका डेटा पूरी तरह से पाठ फ़ाइलों के रूप में संग्रहीत करता है। यह हमें आपदा की स्थिति में उन्हें आसानी से पढ़ने की अनुमति देता है, क्योंकि हम उन्हें कहीं भी पुनर्स्थापित कर सकते हैं, और उन्हें कमांड लाइन से grep के माध्यम से खोज सकते हैं, और उन्हें किसी भी पाठ संपादक में पढ़ सकते हैं जो हमें पसंद है।

परिवर्तन प्रबंधन जानकारी, स्टार्टअप / शटडाउन, और कॉन्फ़िगरेशन नोटों के साथ-साथ डीएनएस, फ़ायरवॉल और एसेट जानकारी के लिए प्रत्येक सर्वर में एक पृष्ठ होता है, जो उप-पृष्ठों का एक मानक संग्रह होता है।


2

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

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


2

एनजीओ में जहां मैं काम करता हूं, हम सिर्फ महत्वपूर्ण प्रक्रियाओं के लिए एक फ़ोल्डर में रखी गई पाठ फ़ाइलों का उपयोग करते हैं। व्यक्तिगत रूप से एक सिस्टम एडमिनिस्ट्रेटर / वेब डेवलपर हाइब्रिड के रूप में, मैं ट्री डायरेक्टरी में बिखरे हुए टेक्स्ट फाइलों के ज्ञान के आधार का उपयोग कर रहा हूं, यह मेरा मेमेक्स है और मैं इस पर लगभग सब कुछ (व्यक्तिगत, काम आदि) लिखता हूं । यह योजना टेक्स्ट प्रोसेसिंग के लिए जेडिट एक वास्तविक स्विस सेना चाकू का उपयोग करने का प्रबंधन करने के लिए बहुत आसान है , मुझे इसकी रूपरेखा प्लग-इन, कोड तह और हाइपरसर्च सुविधाओं को अपरिहार्य मिल गया है। यह सब सुरक्षित रूप से ssh-accesible दूरस्थ सर्वर के लिए rsync द्वारा समर्थित है।

वैकल्पिक शब्द

युगल जो कि मकलिंक फ़ायरफ़ॉक्स एक्सटेंशन के साथ है और आपके पास सही बुकमार्क प्रबंधक है।




1

हम दस्तावेजों / चित्रों को संग्रहीत करने के लिए सामग्री और SharePoint के लिए स्क्रू टर्न का उपयोग कर रहे हैं।



1

हम grep के साथ त्वरित खोज के लिए पाठ फ़ाइलों के संयोजन का उपयोग करते हैं। और इन-डेप्थ डॉक्यूमेंटेशन (Visio आरेख, आदि) के अधिक संगठित संग्रह के लिए SharePoint।


1

Google Apps (एंटरप्राइज़) ग्राहकों के रूप में, हम Google साइटों से हटकर उपयोग करते हैं - उनका विकि "स्वाद"। उपयोग करने में आसान और हम प्रवेश और डेवलपर्स से महान गोद लिया है।


1

एक और प्रश्न का उत्तर देने से पहले मैंने यह प्रश्न नहीं देखा था , लेकिन यहाँ हम चलते हैं।

हम कई उपकरण और विधियों का उपयोग करते हैं।

  • बुनियादी ढांचे के घटकों और सॉफ्टवेयर के लिए कार्यात्मक विनिर्देश
  • दो संगम विकी । आंतरिक कॉर्पोरेट प्रलेखन (नीतियों, प्रक्रियाओं, आंतरिक बुनियादी ढांचे और आईटी, आदि) के लिए एक और हमारे ओपन सोर्स सॉफ़्टवेयर उत्पादों के लिए एक।
  • RSpec और ककड़ी परीक्षण। हमारे सॉफ्टवेयर ज्यादातर रूबी में लिखे गए हैं, और हम BDD / TDD का अभ्यास करते हैं , इसलिए विनिर्देश परीक्षण वास्तविक कोड, और दस्तावेज़ को भी चलाते हैं।
  • इनलाइन कोड प्रलेखन। हम कोड टिप्पणियों में RDoc मार्कअप का उपयोग करते हैं ।
  • घोषणात्मक विन्यास प्रबंधन ( बावर्ची )। हमारे सभी सर्वर बावर्ची के साथ प्रबंधित होते हैं, जो व्यंजनों और रसोई की किताबों में delcarative संसाधनों के माध्यम से "स्व दस्तावेजों"।

हम कंफ्लुएंस को पसंद करते हैं क्योंकि यह बहुत ही लचीला और शक्तिशाली है और पूर्ण रूप से फीचर है, साथ ही यह टिकट प्रबंधन सॉफ्टवेयर में भी शामिल है जिसे हम पसंद करते हैं, जीरा

पिछली कंपनियों में, जिन पर मैंने काम किया है, मैंने विभिन्न प्रकार के औजारों और विधियों का उपयोग किया है और कई लोगों ने हर चीज के लिए एकल कैच-ऑल रिसोर्स (जैसे विकी) के साथ रहने की कोशिश की है। इसके साथ समस्या यह है कि एक ही उपकरण के साथ विभिन्न विषयों का दस्तावेजीकरण किया जा रहा है, जो उस विषय को कवर करने के लिए विशिष्ट रूप से अनुकूल नहीं है, इसका मतलब है कि कई चीजों को बिल्कुल भी दस्तावेज नहीं मिलेगा, क्योंकि जानकारी को स्थानांतरित करना मुश्किल है। यूनिक्स / लिनक्स geek के रूप में, मेरा मानना ​​है कि प्रत्येक कार्य के लिए एक विशिष्ट उपकरण की आवश्यकता होती है, और उस उपकरण को उस कार्य को अच्छी तरह से फिट करना चाहिए।


1

यह प्रश्न इस एक की बहुत अच्छी तरह से एक डुप्लिकेट है और मैंने अपना जवाब वहां दिया।


1

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

हमने कोड समीक्षा के लिए "पीयर रिव्यू" एक्सटेंशन का उपयोग करते हुए ट्राक के साथ हमारे बग और आगामी कार्यों का दस्तावेजीकरण शुरू किया है । हमारी टीम से इसे बहुत स्वीकृति मिली है क्योंकि इसमें सहयोग करना सरल है और नेविगेट करना आसान है। कुछ अन्य टीम के सदस्यों ने विनिर्देशों, परीक्षण प्रक्रियाओं और मैनुअल के साथ अधिक सहयोग शुरू करने की इच्छा व्यक्त की है, इसलिए हम DocBook / XML में देख रहे हैं, जैसे मैनुअल, और आंतरिक दस्तावेज़ों के लिए Trac WIKI पृष्ठों को PDF में निर्यात किया गया है। परीक्षण प्रक्रियाएँ।

मेरे दिमाग में, प्रलेखन प्रारूप चुनते समय सबसे बड़े मुद्दे हैं:

  1. क्या इसे बनाना आसान है?
  2. क्या इसे बनाए रखना आसान है?
  3. अगर किसी और ने लिखा तो क्या इसे बनाए रखना आसान है?
  4. क्या इसे ज्यादा परेशानी के बिना अन्य स्वरूपों में निर्यात / परिवर्तित किया जा सकता है?

1-3 मेरे जीवन को आसान बनाते हैं, और पागल होने के बिना जल्दी से प्रलेखन के उत्पादन के लिए महत्वपूर्ण हैं। मुझे लगता है कि ग्राहक समाप्ति पर चौथा सबसे महत्वपूर्ण है, क्योंकि प्रारूप लगातार बदलते जा रहे हैं। Microsoft Word 2003 प्रारूप हमेशा के लिए चारों ओर होने वाला नहीं है, और न ही हमारी पीडीएफ का वर्तमान कार्यान्वयन है। मुझे यह सुनिश्चित करने की ज़रूरत है कि हमारे सभी ग्राहक हमारे दस्तावेज़ पढ़ सकते हैं, चाहे उनका ओएस या दस्तावेज़ पाठक-पसंद कोई भी हो।


1

हम मीडियाविकि का उपयोग विभिन्न प्लगइन्स के साथ करते हैं, जिसमें सेमेटिकमैडियाविक भी शामिल है। SMW अच्छा है क्योंकि यह हमारे MediaWiki इंस्टॉलेशन को एक बड़े, फ्री-फॉर्म रिलेशनल डेटाबेस में बदल देता है जिसे वसीयत में क्वेर किया जा सकता है। यह जानने की जरूरत है कि किस वेबसाइट पर कौन सा सर्वर है? यह पृष्ठ पर जाएँ। यह जानने की आवश्यकता है कि किसी सर्वर पर कौन सी वेबसाइटें होस्ट की जाती हैं? एक क्वेरी चलाएँ, और यह प्रत्येक वेबसाइट के पेज पर उचित टैग के आधार पर पृष्ठ के नाम को उठाएगा।


1

मैं एक प्रलेखन प्रणाली मैं का इस्तेमाल किया है के साथ नहीं का जवाब देंगे, लेकिन कुछ के साथ मैं है देखा इस्तेमाल किया और जो मुझे बहुत अच्छा लगता है: http://stackexchange.com/

stackexchange Q & A प्लेटफ़ॉर्म है जो सर्वरफ़ॉल्ट के तहत चलता है (ठीक है, तकनीकी रूप से यह बिल्कुल समान नहीं है, लेकिन हमारे उद्देश्य के लिए हम मान सकते हैं कि यह समान है)।

फोगबुग इसका इस्तेमाल करता है

एक दिलचस्प ब्लॉग पोस्ट है जिसमें एक फोगबुग कर्मचारी है जहाँ मुझे ये उद्धरण मिले हैं:

उत्पाद चश्मा के बाहर सभी उद्देश्यों के लिए, मुझे लगता है कि कॉर्पोरेट विकी और चर्चा रूपों को एक घातक झटका दिया गया है।

...

जब से हमने FogBugz.StackExchange.com को हमारे समर्थन प्लेटफॉर्म के रूप में उपयोग करना शुरू किया है, मैंने कभी भी एक ही प्रश्न का दो बार उत्तर नहीं दिया है। हमारे पास एक आंतरिक एसई सर्वर भी है जिसका उपयोग हम गैर-सार्वजनिक-सामना करने वाले प्रश्नोत्तर के लिए करते हैं, और वही सिद्धांत वहां लागू होते हैं।

वे ग्राहक-सामना ज्ञान आधार और आंतरिक ज्ञान आधार के लिए स्टैकएक्सचेंज का उपयोग करते हैं।

मुझे यह देखने में दिलचस्पी है कि क्या इस तरह के ज्ञान का आदान-प्रदान Q & A प्लेटफॉर्म कॉर्पोरेट विकी की जगह लेगा।


0

अपने पिछले नियोक्ता में मैंने एक फ़ोल्डर में वर्ड, एक्सेल और विज़ियो फाइलों को एक साथ एकत्र किया था। मेरे डेस्क में एक बाइंडर में हर चीज की हार्ड-कॉपी रखी गई थी। मैं इकलौता आईटी व्यक्ति था इसलिए किसी और को जानकारी हासिल करने की बहुत कम जरूरत थी।

मेरे वर्तमान नियोक्ता में हम सटीक सॉफ्टवेयर द्वारा मैकोला ES का उपयोग करते हैं, लेकिन मैं अभी भी अपने दस्तावेज़ को वर्ड में लिखना पसंद करता हूं और इसे अंतर्निहित दस्तावेज़ संपादक का उपयोग करने की तुलना में एक अनुलग्नक के रूप में मैकोला में अपलोड करना चाहता हूं।


0

अपने कार्यस्थल पर, मैंने हमारे विंडोज देव सर्वरों में से एक पर स्क्रैच विकी को गिरा दिया और इसे हमारे SQL सर्वर तक पहुंचा दिया। यह वास्तव में अच्छी तरह से काम करता है, जल्दी से चलता है, और मुख्य रूप से प्रलेखन के लिए हमारे रास्ते से बाहर रहता है। दो हफ्तों के बाद से यह तैनात किया गया है, हमने पहले ही लगभग 60 पृष्ठों की जानकारी जोड़ी है, और यह केवल हमारी टीम (~ 10 लोगों) के लिए है।

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

विकी पर मेरे पसंदीदा पृष्ठों में से एक उपकरण और पुस्तकालय पृष्ठ रहा है। वहां, हमने अपने पसंदीदा उत्पादकता टूल और पुस्तकालयों के बारे में जानकारी जोड़ना शुरू कर दिया है, जिनका हम बहुत उपयोग करते हैं, जिसका एक उदाहरण है विंडोज में पाठ खोज के लिए grepWin।

मैं पूरी तरह से विकी के उपलब्ध होने की पूरी जाँच करने की सलाह दूंगा और ऐसा कोई खोजूंगा जो आपके इच्छित उपयोग, कार्यक्षमता और तैनाती के वातावरण के अनुकूल हो। मैंने स्क्रैच को चुना क्योंकि इसका उपयोग करना आसान है, और हमारे पास हमारे स्थानीय WinServer पर एक मुफ्त कमरा है, लेकिन YMMV।


0

हम कुछ मामलों में दस्तावेजों के लिए कॉन्फ्लुएंस को विकि और शेयरपॉइंट के रूप में उपयोग कर रहे हैं। मेरा मानना ​​है कि ऑनलाइन विकी प्रारूप एक पसंद किया जाता है जब आपको इस जानकारी को वास्तव में व्यापक रूप से साझा करने की आवश्यकता होती है और जब दस्तावेज़ बहुत बार संपादित और अपडेट किए जाने वाले होते हैं तो यह अधिक महत्वपूर्ण होता है। इसलिए मुझे लगता है कि ज्ञान के आधार लेखों को विकि में रखना बेहतर है।


0

वर्तमान में हम नेटवर्क के आसपास फैले विभिन्न दस्तावेजों से अपनी जानकारी दो स्थानों पर ले जा रहे हैं:

  1. हमारे इंट्रानेट पर उपलब्ध एक विकी
  2. उस सर्वर / रूट निर्देशिका में किसी विशेष सर्वर से संबंधित जानकारी की एक प्रति।

नेटवर्क आरेख के लिए, नेटवर्क नोटपैड

इसके अलावा, क्या रिकॉर्ड करते समय, रिकॉर्ड करना याद रखें कि कुछ ऐसा क्यों कॉन्फ़िगर किया गया है। यह उन विचारों को रोकने में मदद करता है जो गलतियों में बदलने से एक अच्छे विचार की तरह लगते हैं।


0

हमने पाया है कि मीडियाविकि एक धीमा स्टार्टर रहा है, लेकिन एक बार आईटी के बाहर के लोगों को टिप्पणी, परिवर्तन, संपादन इत्यादि को जोड़ना कितना आसान हो गया, यह अपरिहार्य हो गया। डेवलपर्स इसे आंतरिक प्रलेखन, सुविधाओं के लिए उपयोग कर रहे हैं। नोटिस पोस्ट करने के लिए, आदि यह सिर्फ एक आईटी प्रलेखन उपकरण होने से परे हो गया है।

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