हम इनलाइन एक्सएमएल टिप्पणियों से कक्षा पुस्तकालय दस्तावेज उत्पन्न करने के लिए sandcastle (और SHFB) का उपयोग करते हैं। यह correct code samples समेत पूर्ण और पेशेवर दिखने वाले संदर्भ + ओवरव्यू दस्तावेज़ों को बनाए रखने के लिए एक शानदार टूल है।क्या हम sandcastle तेज कर सकते हैं?
दुर्भाग्यवश, यह भी कुत्ता धीमा है। यह हमारे स्वचालित निर्माण का सबसे अधिक समय लेने वाला कदम है, और यह चोट लगाना शुरू कर रहा है। क्या इसे गति देने का कोई तरीका है?
कोडप्लेक्स पर चर्चा समूह बहुत सक्रिय और जानकार है। यहां विषय पोस्ट पर अर्द्ध है (हालांकि कोई मदद नहीं): http://sandcastle.codeplex.com/Thread/View.aspx?ThreadId=32267
यदि आपके पास SdkLinkType = Msdn (आपके SHFB प्रोजेक्ट के गुण देखें) sandcastle वेब सेवा का उपयोग कर एमएसडीएन दस्तावेज से जुड़ता है। कनेक्शन की परेशानी के मामले में यह slooowww निर्माण कर सकते हैं। आप एमएसडीएन लिंक बनाने के लिए SdkLinkType = कोई भी सेट करने का प्रयास नहीं कर सकते (उस स्थिति में आपके पास आपकी सहायता में एमएसडीएन के लिंक नहीं होंगे)। मेरे मामले में जो मेरे निर्माण समय में 5 गुना सुधार (10 मिनट के बजाय 2 मिनट)।
मैं आपको अपने दस्तावेज़ों को तुरंत देखने के लिए [लाइव डॉक्यूमेंटर] (http://theboxsoftware.com/products/live-documenter/ "लाइव डॉक्यूमेंटर") का उपयोग करने की सलाह देता हूं। कार्यक्रम केवल आपके दस्तावेज़ को एक्सएमएल फ़ाइल से देखता है जो प्रत्येक बिल्ड पर उत्पन्न होता है। जब आप अपने प्रलेखन से खुश होते हैं, तो वास्तव में इसे बनाने के लिए sandcastle का उपयोग करें। –
@ जेरेडबीच: समस्या तब होती है जब निर्माण की तैयारी करते समय सैंडकासल कई कदमों में से एक होता है (निश्चित रूप से एक स्क्रिप्ट द्वारा स्वचालित)। दस्तावेज़ीकरण का पूर्वावलोकन करना भी एक लक्ष्य नहीं हो सकता है; किसी भी कारण से रिलीज फ़ाइलों को इकट्ठा करते समय सैंडकासल बस कई उपकरणों में से एक के रूप में चलाया जाता है। –