विशिष्टताओं और प्रलेखन के लिए विकी जैसा उपकरण [बंद]

Question

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

मुझे पता है कि विकी-कार्यान्वयन बहुत सारे उपलब्ध हैं, लेकिन क्या कुछ ऐसे हैं जो इस तरह के कार्य के लिए विशेष रूप से अनुकूल हैं?

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

Comments

क्या आप एक विशेष मंच का उपयोग कर रहे हैं? उदाहरण के लिए Microsoft का TFS पसंद है?

— सईद नीमाटी

@ सईद ने जो कुछ पूछा, उसकी तर्ज पर आपकी टीम / संगठन में पहले से ही ज्ञान प्रबंधन और साझा करने के लिए किस तरह का बुनियादी ढांचा है? इसके अलावा, चश्मा और डॉक्स लिखने की आपकी वर्तमान प्रक्रियाएँ क्या हैं?

— थॉमस ओवेन्स

Answer 1

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

आपके द्वारा उपयोग किए जा रहे संस्करण नियंत्रण के सभी लाभ (और नुकसान, स्वीकार किए जाते हैं) आपके कोड के साथ उपयोग करने से मिलते हैं।

LaTeX एक छोटी सी सेटिंग लेता है (अपनी खुद की शैलियों / वर्ग को परिभाषित करने के लिए), लेकिन एक बार जब आप ऐसा कर लेते हैं तो यह बहुत अच्छा होता है - आप अपनी प्रस्तुति के बजाय केवल सामग्री पर ध्यान केंद्रित कर सकते हैं (बजाय लगातार ट्वीक किए जाने के लिए लुभाए जाने के बजाय) WYSIWYG), अभी भी अंत में एक चालाक, पेशेवर दिखने वाला पीडीएफ दस्तावेज़ प्राप्त करता है।

Answer 2

निजी तौर पर, मैं वास्तव में टिडली विकी को पसंद करता हूं ।

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

यहां तक ​​कि इसमें एक एक्स्टेंसिबल प्लगइन आर्किटेक्चर भी है, जो आपको सभी प्रकार की दिलचस्प चीजों जैसे कि टिडलर को एन्क्रिप्ट करने या स्नैक्स को जोड़ने के लिए प्लगइन्स को जोड़ने की अनुमति देता है।

Answer 3

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

अन्य प्लेटफार्मों के लिए, मुझे लगता है कि आप GitHub की तरह कुछ का उपयोग कर सकते हैं (हालांकि, मुझे इसके बारे में निश्चित नहीं है)।

Answer 4

व्यक्तिगत परियोजना के लिए (केवल मेरे पीसी में) मैं एक जार में विकी का उपयोग करता हूं । पूर्व में मैंने रेडमाइन के साथ काम किया था (इसमें बग ट्रैकिंग और एससीएम की एक प्रणाली है)

Answer 5

आप अपने स्रोत नियंत्रण प्रबंधन पसंद के बुनियादी ढांचे में जाँच किए गए दस्तावेजों के साथ स्फिंक्स की कोशिश कर सकते हैं। यह स्रोत नियंत्रण और एक अपेक्षाकृत हल्के मार्कअप भाषा के फायदे हैं, reStructuredText , जो सीखना आसान है और रूपांतरण के लिए (HTML, PDF, और इसी तरह) के लिए बहुत अच्छा साधन है।