2010-08-30 7 views
8

मुझे a statement on the DotNetNuke pages about the documentation के साथ कोई कठिनाई है जब आप एक पेशेवर या उच्च लाइसेंस के लिए $ 2000 या अधिक भुगतान करते हैं तो केवल तभी उपलब्ध होता है। मांगों को बनाए रखने के लिए डीएनएन समुदाय के कड़ी मेहनत के बावजूद मंचों के साथ मंचों में बाढ़ आ गई है, कई डुप्लीकेट, many unansweredक्या डॉटनेटनेट दस्तावेज़ वास्तव में काफी हद तक शून्य है या क्या यह केवल वाणिज्यिक संस्करणों में उपलब्ध है?

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

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

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

+0

@closers: ठीक है, मैं समझता हूं कि मैं कुछ व्यक्तिपरक शब्द का उपयोग करता हूं, लेकिन सवाल: * "क्या मैं एक पेशेवर संस्करण होने पर प्रलेखन देख सकता हूं, या मुझे कहां से शुरू करना चाहिए?" *, एक वैध प्रश्न है , क्या ऐसा नहीं है? बेशक, मैं, और मेरे कई सहकर्मियों को अक्सर डीएनएन के अप-टू-डेट दस्तावेज की कमी से निराश होता है। – Abel

+0

दस्तावेज़ीकरण की कमी अक्सर ओपन सोर्स प्रोजेक्ट्स के साथ एक समस्या है। कोड लिखना मजेदार है, कम लोगों को लगता है कि इसके लिए दस्तावेज लिखना मजेदार है। – driis

+0

पुस्तकें: http://www.dotnetnuke.com/Support/Documentation/DotNetNukeBooks/tabid/1334/Default.aspx –

उत्तर

5

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

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

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

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

फ़ोरम के लिए, हाँ, मैं मानता हूं कि वे निराशाजनक हो सकते हैं। यह एक कारण है कि मेरी साइट पर फ़ोरम (http://www.mitchelsellers.com) अक्सर होते हैं क्योंकि उन्हें थोड़ा बेहतर एक्सपोजर मिलता है। एक अन्य वस्तु जो समुदाय के लिए बहुत अच्छी हो सकती है, हाल ही में प्रस्तावित DotNetNuke StackExchange site है। यदि आपने पहले से ऐसा नहीं किया है, तो मैं बाहर जाऊंगा और आपका समर्थन दिखाऊंगा!

कुल मिलाकर हालांकि मुझे आपका दर्द महसूस होता है, मैं अब 4 साल से अधिक समय तक डॉटनेटनेट समुदाय में एक सक्रिय सदस्य रहा हूं, और कई बार मुश्किल हो सकता है, लेकिन अंत में, यह हमेशा इसके लायक है।

+0

+1 फिर से, यह चीजों को थोड़ा और समझ में आता है और मुझे अन्य मंचों से अवगत नहीं था, मुझे यकीन है कि एक नज़र डालें। (मैं स्वीकार किए गए उत्तरों को बदल दूंगा, मेरा मानना ​​है कि यह मेरा मूल इरादा बेहतर जवाब देता है, भले ही मेरा मूल क्यू खराब और भ्रामक शब्द था)। – Abel

0

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

+0

प्रश्न संशोधित किया गया है कोर के 'पोर्टलसेटिंग' भाग जैसे वर्गों पर विचार करें, लेकिन उन्हें दस्तावेज नहीं किया गया है। बेशक, ढांचे की बाधाओं का पालन किया जाना चाहिए, अच्छा बिंदु, लेकिन मॉड्यूल डेवलपर्स द्वारा सार्वजनिक विधियों का उपयोग किया जाना चाहिए। आप वर्तमान लॉगिन प्रदाता को कहने में सक्षम कैसे होंगे? लेकिन 'पोर्टल मॉड्यूलबेस' (सभी मॉड्यूल के लिए उपयोग किया जाता है) समान रूप से बुरी तरह से प्रलेखित है ..., बिल्ली, मैं '* .dnn' xml फ़ाइलों के लिए XML स्कीमा का एक दस्तावेज़ भी नहीं ढूंढ सकता ... – Abel

3

पल के लिए, मैं तार्किक स्वर कि सबसे अधिक संभावना मेरी किताब की लेखन शैली की दिशा में प्रेरित है से बचने और आप इस पर कुछ संकेत दे देंगे।

  1. एपीआई दस्तावेज उपलब्ध है, हालांकि एक वास्तविक एपीआई परिप्रेक्ष्य से दस्तावेज अभी तक 100% नहीं है। DotNetNuke संदर्भ टीम इस दस्तावेज़ की गुणवत्ता में सुधार करने के लिए काम कर रही है, लेकिन जैसा कि आप कल्पना कर सकते हैं कि इसमें कुछ ऐसा करने के लिए काफी समय लगेगा, जिसमें कोई भी नहीं है, यदि कोई हो, तो एपीआई दस्तावेज पूरी तरह से प्रलेखित किया जाए, लेकिन यह है अंतिम लक्ष्य

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

  3. डॉटनेटनेट निगम नई विकी परियोजना बनाकर और एपीआई दस्तावेज को स्नफ करने के लिए वहां प्रलेखन की गुणवत्ता और उपलब्धता में सुधार करने की कोशिश कर रहा है, लेकिन यह एक चरण-दर-चरण प्रक्रिया है।

इस को पूरा करने लेकिन, मैं आपको सलाह की एक त्वरित शब्द दे, वहाँ DotNetNuke समुदाय है, जो हमारे बट खराब दूसरों DNN की समझ पाने में मदद और सभी समय बिताने के लिए में हम में से कई हैं कि हम यहां StackOverflow, DotNetNuke.com, और यहां तक ​​कि हमारे स्वयं के व्यक्तिगत मंचों पर भी करते हैं। यदि आप तर्कवादी दृष्टिकोण से थोड़ा कम लेते हैं, तो आपको कुछ बेहतर उत्तर मिल सकते हैं, और कम से कम आप उन लोगों को परेशान करने का जोखिम नहीं उठाएंगे जो वास्तव में आपके लिए आपके प्रश्नों का उत्तर दे सकते हैं।

+0

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

+0

आपकी पुस्तक पर एक छोटा सा नोट, लेकिन शायद यह चर्चा कहीं और बेहतर अनुकूल है। मैंने इसे मॉड्यूल के विकास में मदद के लिए खरीदा, लेकिन दुर्भाग्य से - और मुझे खेद है - उसने मेरे सवालों के जवाब नहीं दिए और प्रदान किए गए उदाहरणों में गहरा कवरेज नहीं है। इंडेक्स के साथ मेरी छोटी सी गड़बड़ी पर एक उदाहरण: बस एक समर्थन कीवर्ड खोजने की कोशिश करें, जैसे 'supportPartialRendering'। यह वहाँ नहीं है। पृष्ठ द्वारा पुस्तक पृष्ठ पर जाकर मैंने पाया। * भूमिकाएं * आज़माएं: यह रोलप्रोवाइडर पर पृष्ठों को इंगित नहीं करता है और बाद वाला कोई भी नहीं है। लेकिन सभी ईमानदारी से, आपकी पुस्तक ने मुझे कुछ मौकों पर भी बचाया;) – Abel

+0

@abel - मेरा विश्वास करो मैं समझता हूं! मैं 4 या उससे अधिक साल पहले उसी तरह था जब मैंने डीएनएन के साथ शुरुआत की थी, और फिर एफएआर कम दस्तावेज था। सूचकांक मुद्दा ऐसा कुछ है जिस पर मुझे बहुत दिलचस्पी है, क्योंकि मैंने वास्तव में इंडेक्स नहीं बनाया है, और आप इसके बारे में शिकायत करने वाले पहले व्यक्ति नहीं हैं। मुझे यह भी विश्वास है कि डॉटनेटनेट मॉड्यूल डेवलपमेंट पर "गहरी" गोताखोरी की किताब की आवश्यकता है, लेकिन मुझे यकीन नहीं है कि आगे बढ़ने के लिए पर्याप्त समर्थन मिलेगा। –

1

हालांकि आसानी से प्राप्त करने योग्य दस्तावेज की कमी है जो आपके तत्काल जरूरतों और मानकों को पूरा करने वाले विवरणों में एपीआई बताती है, क्योंकि मिशेल का कहना है कि डीएनएन में डिजाइनरों और डेवलपर्स के सर्वश्रेष्ठ "समुदायों" में से एक है जो उनके बाहर जाते हैं एक दूसरे की मदद करने के लिए रास्ता।

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

कम समय में और दृढ़ता किसी अन्य फ्रेमवर्क या भाषा के साथ भुगतान करेगी। और जैसा कि मिशेल का उल्लेख किया

वैसे 'तुम सिरका के साथ की तुलना में शहद के साथ अधिक मक्खियों पकड़ कर सकते हैं' वहाँ विशेष रूप से कुछ आप के लिए देख रहे थे?

+0

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

+0

http://www.dotnetnuke.com/Community/Blogs/tabid/825/EntryId/2758/Help-How-do-I-do-THIS-in -the-DNN-API-Part-3-of-3.aspx –

1

DotNetNuke उपयोगकर्ता मैनुअल अब ऑनलाइन उपलब्ध here हैं। मेरा मानना ​​है कि 5.5.0 के लिए एक अपडेट जल्द ही आ रहा है।

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

एपीआई दस्तावेज को आगे बढ़ाने के लिए एक परियोजना है, डीएनएन कॉर्प हिस्सा ले रहा है और हमेशा समुदाय योगदान को प्रोत्साहित किया जाता है। अर्न्स्ट पीटर तमिंगा ने हाल ही में here के बारे में ब्लॉगिंग किया है।

+0

+1, यह इस चर्चा के लिए एक अच्छा जोड़ा है, और मुझे यह सुनकर खुशी हो रही है कि संदर्भ अधिक से अधिक ध्यान प्राप्त करता है। – Abel

0

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

+0

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

1

मैंने यह एक साल पहले देखा (जैसा शायद मेरे एसओ इतिहास द्वारा प्रमाणित है)।

इस शून्य को भरने के लिए आंशिक रूप से, मैंने बड़ी लाल किताबें पढ़ीं और कई सारे प्रशिक्षण वीडियो देखे। मैं अब एक बड़ी परियोजना के वर्ष 2 में हूं; ~ 50 कस्टम डीएनएन मॉड्यूल और दो डीएनएन कोर परिवर्तन: त्वरित यूआरएल रिवाइटिंग सिस्टम (यूआरएलएमस्टर की क्षमता से परे) और कस्टम 404/301 हैंडलर।

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

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

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