2008-08-19 21 views
17

का उपयोग करने के लिए प्राप्त करना मैं एक जटिल अनुप्रयोग पर काम करता हूं जहां विभिन्न टीम ओवरलैप की डिग्री के साथ अपने मॉड्यूल पर काम करती हैं। थोड़ी देर पहले हमें मीडियाविकी इंस्टेंस की स्थापना हुई, आंशिक रूप से मेरे संकेत पर। मुझे लोगों को वास्तव में इसका उपयोग करने में कठिनाई होती है, अकेले योगदान दें।डेवलपर्स को विकी

मुझे जानकारी साझा करने में बहुत लाभ दिखाई दे सकता है। यह कम से कम उस समय को कम कर सकता है जब हम पहिया को फिर से शुरू करते हैं।

विकी बहुत संरचित नहीं है, लेकिन मुझे यकीन नहीं है कि यह एक समस्या है जब तक आप अपनी आवश्यकता के अनुसार खोज कर सकें।

कोई संकेत?

+0

http://stackoverflow.com/questions/3167909/what-motivates-you-to-document-not-document-your-code – zengr

उत्तर

8

जैसा कि मैंने before का उल्लेख किया है, विकी बहुत असंगठित है।

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

3

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

से What Is a Wiki

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

कुछ "चिपचिपा" आइटम (उप-3 पृष्ठ दस्तावेज़/आरेख/आदि) ढूंढें जो टीम बार-बार बना रही है & इसे विकी पर पोस्ट करें। सुनिश्चित करें कि हर किसी के पास विकी तक पहुंच है और उसे वहां पता है - यदि संभव हो तो अधिसूचना तंत्र स्थापित करें। कुछ भाग्य के साथ, अगली बार उन्हें संस्करण नियंत्रण या उनकी मशीनों से बाहर खोदने के बजाय, उन्हें पहुंचना होगा - उन्हें विकी को हिट करना चाहिए। यदि वे अभी भी नहीं करते हैं, तो यह देखने का प्रयास करें कि वास्तव में विकी का उपयोग करने के लिए टीम के पास पर्याप्त कमी है - सबटलर समस्याएं उनकी अनिच्छा के नीचे झूठ बोल सकती हैं।

4

आप डेवलपर्स को कुछ ऐसा करने के लिए मजबूर नहीं कर सकते हैं जिसके लिए उनका उपयोग करने का कोई प्रोत्साहन नहीं है; दुर्भाग्यवश विकी, दस्तावेज़ीकरण की तरह (अच्छी तरह से, वास्तव में विकी दस्तावेज हैं) डेवलपर्स के लिए शायद ही कभी "कूल" मान है। इसके अलावा, वे पहले से ही देव काम में गहरे हैं - क्या आप वास्तव में उन्हें विकी से परेशान कर सकते हैं?

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

तुम भी एफएफ कोशिश कर सकते हैं:

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

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

कुछ ऐसे क्षेत्र हैं जहां विकी का उपयोग कुछ क्षेत्रों को लॉग करने के लिए किया जा रहा है, लेकिन जो लोग इसे अपडेट करते हैं, वे इसके साथ कुछ और नहीं कर रहे हैं।

मैं अपने विशेष क्षेत्र को दस्तावेज करने के लिए विकी का उपयोग करूंगा, भले ही यह सुविधाजनक मस्तिष्क विस्तार के रूप में कार्य करता हो। एक नया विकास शुरू करते समय मैं इसे उन विचारों के लिए नोटपैड के रूप में उपयोग करता हूं जिन पर मैं प्रगति कर सकता हूं।

यह मदद करेगा अगर प्रबंधन इसे कुछ मुखर समर्थन देगा, भले ही इसे अनिवार्य नहीं बनाया गया हो।

+0

सही नहीं है अब और: वहाँ WYSIWYG विकि हैं। जैसे विकीविग –

+0

मैं मीडियाविकि के लिए एक सीकेईडिट WYSIWYG प्लगइन का उपयोग कर रहा हूं जो काफी अच्छा है: http://www.mediawiki.org/wiki/Extension:FCKeditor_%28Official%29 – mskfisher

6

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

यदि कोई व्यक्ति उस ईमेल से संबंधित ईमेल भेजता है जिसमें परियोजना से संबंधित जानकारी होती है तो उसे विकी की दिशा में मदद से इंगित करें - और ऐसा करने के लिए - उन्हें संकेत मिलना चाहिए।

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

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

+0

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

5

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

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

0

बस उत्कृष्ट सलाह के कुछ यहाँ की पेशकश की जा करने के लिए जोड़ने के लिए आगे बढ़ें ...

एक छोटी कंपनी में एक देव के रूप में जो 6-24 महीने की रेंज में अनुबंध काम नहीं करता है, मुझे लगता है कि मेरा समय अक्सर विकास और लेखन स्थिति रिपोर्ट के बीच विभाजित होता है (केवल लेखन दस्तावेज के साथ, वहां केवल बदतर!) असंगठित विचारों और नोटों को थप्पड़ मारने के लिए विकी होने के साथ-साथ हम साथ-साथ बहुत कम दर्दनाक लिखते हैं (दर्द कम नहीं करते हैं, लेकिन सभी समान होते हैं)।

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

26

कुछ युक्तियां:

किसी भी समय किसी को ईमेल कि वास्तव में एक विकी में होना चाहिए द्वारा जानकारी भेजता है, उस विषय के लिए एक पेज बनाने के लिए और जोड़ने के क्या वे ईमेल में डाल दिया। फिर जवाब दें "उस जानकारी के लिए धन्यवाद, मैंने इसे विकी में रखा है ताकि भविष्य में इसे ढूंढना आसान हो।"

इसी तरह, यदि आपके पास जानकारी है तो आपको विकी में होना चाहिए, इसे वहां रखना होगा और ईमेल लोगों की बजाय इसे एक लिंक के साथ एक ईमेल भेजें।

जब आप लोगों को जानकारी के लिए पूछते हैं, तो वाक्यांश यह है कि विकी में ऐसे दस्तावेज डालने को डिफ़ॉल्ट या मानक माना जाना चाहिए: "मैंने विकी में खोज की लेकिन मुझे यह नहीं मिला। क्या आपने उस जानकारी को वहां रखा है अभी तक? "

यदि आप "विकी चैंपियन" हैं, तो सुनिश्चित करें कि अन्य लोग इसका उपयोग कैसे करें, उदाहरण के लिए "क्या मैंने अभी तक आपके साथ एक नया पृष्ठ बनाने का तरीका बताया है?"

यह सुनिश्चित करने के लिए साइडबार संपादित करें कि यह आपके काम के लिए प्रासंगिक है।

आसान नेविगेशन के लिए संबंधित पृष्ठों पर "एनवी बॉक्स" शैली टेम्पलेट का उपयोग करें।

सामने वाले पृष्ठ पर {{स्पेशल: न्यूपेज/5}} जैसे कुछ या हालिया परिवर्तनों को रखें, ताकि लोग गतिविधि देख सकें।

हर कुछ दिनों या सप्ताह में हालिया परिवर्तनों पर एक नज़र डालें, और यदि आप किसी को बिना किसी जानकारी के जानकारी जोड़ते हुए देखते हैं, तो उन्हें एक ईमेल भेजें या छोड़ दें और उन्हें थोड़ी तारीफ दें।

+0

मैं पहले से ही बहुत सी चीजें करता हूं। हमारे क्यूए और कार्यान्वयन विभाग विकी का उपयोग शुरू कर रहे हैं, इसलिए उम्मीद है। मैं उन मॉड्यूल को दस्तावेज करने वाले अधिक डेवलपर देखना चाहता हूं जिन पर वे काम करते हैं। मैं केवल अपने फायदे के लिए ऐसा करूँगा। – steevc

+0

{{स्पेशल: न्यूपेज}} के लिए आइटम गिनती सीमित करने के लिए सही वाक्यविन्यास {{स्पेशल: न्यूपेज/5}} –

+0

धन्यवाद एबिन - अब – pfctdayelise

1

मुझे लोगों को वास्तव में इसका उपयोग करने में कठिनाई होती है, अकेले योगदान दें।

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

ताकि अन्य (उपयोगकर्ता/स्वयंसेवक) आसानी से ऐसी सामग्री ले सकें और उन्हें विकी पर रख सकें।

यह वास्तव में अधिक जटिल लगता है, यह ज्यादातर प्रश्नों और उत्तरों को सामान्य करने के बारे में है, ताकि वे एक वार्तालाप का हिस्सा न हों, लेकिन एक स्टैंडअलोन फैशन में समझदार, सार्थक और उपयोगी हो सकते हैं।

उदाहरण के लिए निम्नलिखित की तरह एक सवाल:

मैं कैसे एक दूरस्थ भंडार क्लोन करने के लिए Git मिलता है ???

इस तरह जवाब दिया जा सकता है:

हैलो, बस Git क्लोन Git का उपयोग: // ...

लेकिन सवाल यह भी एक कम व्यक्तिगत शैली में जवाब दिया जा सकता:

एक गिट भंडार क्लोन करने के लिए, आप गिट के लिए क्लोन पैरामीटर का उपयोग करना चाहेंगे: गिट सी अकेला गिट: // ....

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

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

असल में, यह लोगों को विकी में योगदान करने के लिए सबसे आसान तरीकों में से एक है, बिना उन्हें वास्तव में इसका उपयोग करने की आवश्यकता के बिना, उनमें से केवल एक चीज सोचने में बदलाव है।

1

यदि डेवलपर्स को अभी भी 'वास्तविक' दस्तावेज (एसए वर्ड दस्तावेज़) को बनाए रखने की आवश्यकता है, तो मुझे विकी पर सार्थक रूप से डुप्लिकेट करने का कोई तरीका नहीं दिखता है।

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

मेरा वर्तमान ग्राहक क्या किया है यह सब विकी को ले जाया गया है। तो मैं केवल एक बार दस्तावेज़ करता हूं, और मैं विकी पर करता हूं।

यह ठीक है। विकी के साथ काम करना शब्द के मुकाबले ज्यादा कठिन है, लेकिन कम से कम दस्तावेज़ ऑनलाइन है और अन्य इसके साथ मिश्रित और मिलान कर सकते हैं।

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

0

आम तौर पर यहां अच्छी सलाह है।मैं जोड़ना चाहते हैं:

  1. आप वास्तव में जरूरत है एक चैंपियन - कोई (pushy किया जा रहा बिना - कि एक चुनौती है!) डेवलपर्स और प्रबंधन को यह धक्का और जब संभव समर्थन & ट्यूटोरियल प्रदान करते हैं। इस व्यक्ति को भी एक सहकर्मी होना चाहिए (इसलिए एक साथी डेवलपर, रिमोट आईटी विभाग में कोई नहीं) और वास्तव में ग्राहक केंद्रित है, अनुरोध करते समय परिवर्तन करने के लिए तैयार है।
  2. परिवर्तनों की बात करते हुए, कुछ लोग यहां कहते हैं कि विकी असंगठित हैं। मैं असहमत हूं। हमारी मीडियाविकि स्थापना श्रेणियों का उपयोग करके संरचित है, विशेष रूप से दो एक्सटेंशन: WarnNoCategories (उपयोगकर्ताओं को पृष्ठ सहेजते समय एक श्रेणी जोड़ने की आवश्यकता होती है) और CategoryTree यह दिखाने के लिए कि सभी श्रेणियां एक साथ कैसे फिट होती हैं (इसे साइडबार से जोड़ा जा सकता है)। यदि आप रुचि रखते हैं, तो मुझे इस बारे में और युक्तियां मिलती हैं कि हम इस कम सीमा को कैसे रखते हैं।
+0

को सही किया गया है कृपया प्रारंभिक चरण में यह विकी क्यू एंड ए फोरम भी देखें: http: // area51 .stackexchange.com/प्रस्तावों/13,716/विकि संपादित करें – Wikis

संबंधित मुद्दे