हम अपने सभी विनिर्देशों (और अन्य ग्राहक-सामना दस्तावेज) के लिए DocBook का उपयोग करते हैं। डॉकबुक एक एक्सएमएल प्रारूप है जो आपको पीडीएफ समेत किसी भी प्रारूप में दस्तावेजों को आसानी से उत्पन्न करने देता है, इस प्रकार हम उन्हें ग्राहकों को हस्ताक्षर करने के लिए चीजों को वितरित करते हैं। हम दस्तावेज़ को (अनुभाग द्वारा) में एक दस्तावेज़ विभाजित कर सकते हैं और सब कुछ हमारे स्रोत नियंत्रण प्रणाली (सबवर्जन) में कर सकते हैं। चूंकि यह सभी एक्सएमएल (यानी टेक्स्ट-आधारित) है, इसलिए सबवर्सन का स्वचालित विलय और संघर्ष समाधान बहुत अच्छा काम करता है यदि दो लोग एक ही फाइल पर काम करते हैं। हमारे पास स्टाइलशीट का एक सेट है जो हमारे सभी दस्तावेज़ों का उपयोग करते हैं, इसलिए सभी दस्तावेज हमारे हिस्से पर कोई अतिरिक्त काम नहीं करते, समान शैली/प्रारूप साझा करते हैं।
और यदि आप सीधे XML फ़ाइलों को संपादित करना पसंद नहीं करते हैं, तो जीयूआई फ्रंट-एंड हैं जो एक उचित WYSIWYG- जैसा अनुभव प्रदान करते हैं। मेरा मानना है कि मेरे कार्यालय में ज्यादातर लोग XMLMind का उपयोग करते हैं। फिर भी, हम सभी तकनीकी लोगों के साथ होते हैं, इसलिए अगर हमें सीधे एक्सएमएल लिखना पड़ा तो यह कोई मुद्दा नहीं होगा।
एक sidenote के रूप में, हम रिलीज नोट भी डालते हैं। स्वचालित रूप से करने के लिए
<bugs>
<bug id="1234" component="web">JavaScript error when clicking the Kick Me button</bug>
</bugs>
हम तो एक स्क्रिप्ट है कि हमारे सबवर्सन मौजूदा रिलीज टैग करने के लिए पिछले रिलीज टैग से एक svn log
कर भंडार के माध्यम से चलाता है, और कुछ बगजिला एकीकरण: हम कुछ XSLT हमें इस तरह के दस्तावेजों लिखने देता है कि है ऑन-द-फ्लाई रिलीज नोट्स जेनरेट करें।
(यह भी, केवल आंतरिक सबसे प्रलेखन के लिए, हम MediaWiki का उपयोग, जो भी एक शानदार तरीका सहयोग करने के लिए है।)
स्रोत
2009-06-28 09:40:24
@ जेपी: क्या आप कहेंगे कि डब्ल्यूएसएस 3.0 (शेयरपॉइंट का "मुक्त" संस्करण) एमओएसएस 2007 के रूप में उतना ही अच्छा है जितना इस तरह के सहयोग से संबंधित है? –
शुद्ध दस्तावेज़ सहयोग के लिए, हां। लेकिन अगर आप विकी, ब्लॉग, पोर्टल, उपस्थिति प्रबंधन (संचार सर्वर) जैसी चीजें चाहते हैं, तो आपको पूर्ण नाव एमओएसएस की आवश्यकता है। –
मैंने डब्लूएसएस 3.0 में ब्लॉग और विकी का उपयोग किया है - संस्करण जो टीएफएस के साथ आया था। –