Ich habe Schwierigkeiten mit einer Erklärung auf den DotNetNuke-Seiten über die Dokumentation > Nur verfügbar, wenn Sie für eine professionelle oder höhere Lizenz 2000 $ oder mehr bezahlen. Die Foren sind mit Fragen überflutet, viele dupliziert, Viele blieben unbeantwortet, trotz der harten Arbeit der DNN-Community, um mit der Nachfrage Schritt zu halten.
Ich habe die Bücher ausprobiert, aber sie haben mir nicht die Antworten geliefert, die ich suchte, und während der Enthusiasmus der Schreiber klar ist, werden das ausführliche Drucken von großen Kesselplattenbeispielen und der Mangel an Informationen oder Berichterstattung von neu eingeführt Schlüsselwörter gaben mir nicht das tiefere Verständnis, das ich als Modulentwickler sehnte.
Ich bin einerseits der Meinung, dass DotNetNuke ein großartiger Ort ist, um dort zu sein, andererseits aber jedes Mal, wenn ich diesen One-Liner an Informationen über eine Methode brauche, endlos lange danach suche Durch den Code zu gehen und Reverse Engineering ist dann mein bester Freund.
Ich bin neugierig, warum ist ein Produkt, das es schon so lange gibt, so schlecht dokumentiert auf der Grundlage der API? Es gibt schließlich ein ziemlich großes Handelsunternehmen, das von der Erweiterbarkeit des Produkts profitiert. Habe ich recht, wenn ich verstehe, dass Sie diese Dokumentation nur bekommen, wenn Sie teuer bezahlen? Oder haben Modulentwicklungsunternehmen einen speziellen Zugang?
Ich schreibe hier eine zweite Antwort, da es bei der überarbeiteten Frage eine völlig andere Betrachtungsweise gibt.
In Bezug auf das Benutzerhandbuch der DotNetNuke Professional Edition ist es sehr wichtig, dass Sie genau verstehen, was das Handbuch ist. Es handelt sich NICHT um ein Entwicklerhandbuch oder eine API-Dokumentation, sondern um eine Dokumentation zur Benutzeroberfläche. Wie man eine Seite hinzufügt, wie man ein Modul zu einer Seite hinzufügt, wie man eine Skin installiert, Dinge dieser Art. Ja, dieses Buch ist ein "PE Feature", richtig falsch oder gleichgültig, es wird einem Entwickler mit dem Verständnis der DotNetNuke Plattform nicht helfen.
Ich denke, dies ist ein wichtiger Unterschied, da das PE-Feature-Set wirklich auf Business-Implementierungen ausgerichtet ist, nicht unbedingt auf die Entwickler-Implementierung. Die gesamte Bewegung zur Verbesserung der Entwicklerdokumentation und Entwicklerfunktionalität wird von der Community und nicht unbedingt von den PE-Kunden vorangetrieben.
Es gibt noch andere Gründe dafür: PE kommt mit einigen Modulen, die kürzlich von der DotNetNuke Corporation erworben wurden, diese Module müssen ebenfalls eine Dokumentation haben, was vermutlich ein weiterer Teil des UI-Dokuments ist, auf das verwiesen wird Ihr Link in der Post.
Was die Foren angeht, ja, ich stimme zu, dass sie frustrierend sein können. Dies ist einer der Gründe, warum die Foren auf meiner Website ( Ссылка ) häufig besucht werden, da sie eine etwas bessere Präsenz bekommen. Ein weiterer Gegenstand, der für die Community von großem Nutzen sein könnte, ist meine kürzlich vorgeschlagene DotNetNuke StackExchange-Site . Wenn du es noch nicht getan hast, würde ich gehen und deine Unterstützung zeigen!
Insgesamt, obwohl ich deine Schmerzen fühle, bin ich seit über 4 Jahren ein aktives Mitglied in der DotNetNuke Community und es kann manchmal hart sein, aber am Ende ist es das immer wert.
Die API-Dokumentation ist verfügbar, obwohl die Dokumentation aus echter API-Perspektive noch nicht zu 100% vorhanden ist. Das DotNetNuke-Referenzteam arbeitet daran, die Qualität dieser Dokumentation zu verbessern, aber wie Sie sich vorstellen können, wird es sehr lange dauern, um etwas zu bekommen, das nicht viel, wenn überhaupt, API-Dokumentation vollständig dokumentiert hat, aber das ist das Endziel.
Die Bücher, die es momentan gibt, sind einige der besten Gesamtdokumentationen zur DNN-Entwicklung, ABER sie decken nur einen bestimmten Teil des Prozesses ab. Zum Beispiel enthält mein Buch eines der einzigen Elemente, die das neue DNN 5.x-Manifestformat dokumentieren. Da das Buch jedoch seit über einem Jahr nicht mehr verfügbar ist, wurden dem Manifest Elemente hinzugefügt, die im Buch nicht behandelt werden.
Die DotNetNuke Corporation versucht, die Qualität und Verfügbarkeit der Dokumentation dort zu verbessern, indem sie das neue Wiki-Projekt erstellen und die API-Dokumentation auf den neuesten Stand bringen, aber es ist ein Schritt-für-Schritt-Prozess.
>Aber um das zu beenden, lassen Sie mich Ihnen einen kurzen Ratschlag geben. Es gibt viele von uns in der DotNetNuke-Community, die unsere Ärsche zerbrechen, um anderen zu helfen, DNN zu verstehen und die ganze Zeit, die wir hier tun, zu verbringen StackOverflow, DotNetNuke.com und sogar unsere eigenen persönlichen Foren. Wenn Sie etwas weniger argumentativ vorgehen, erhalten Sie möglicherweise bessere Antworten, und Sie riskieren zumindest nicht, die Leute zu irritieren, die Ihre Fragen wirklich für Sie beantworten können.
Es gibt zwar eine leicht verfügbare Dokumentation, die die API in Details erklärt, die Ihre unmittelbaren Bedürfnisse und / oder Standards erfüllen können, da DNN eine der besten "Communities" von Designern und Entwicklern hat, die sich um nichts kümmern um einander zu helfen.
Es gibt viele Bücher, die mit dem Ziel geschrieben wurden, einen Programmierer oder IT-orientierte Person mit DNN zu erreichen, obwohl sie Ihnen vielleicht nicht die Details geben, die Sie in einem bestimmten Bereich suchen. Ich bin mir sicher, dass es keinen gibt Autor, der nicht sein Bestes tun würde, um eine Frage zu beantworten, die nach dem Lesen des Buches nicht beantwortet wurde, wenn Sie sie kontaktiert haben. Es gibt zahlreiche Blogs und Websites, die voller Informationen und Foren sind, mit Menschen, die bereitwillig ihr Wissen mit denen teilen, die versuchen zu lernen. Ich habe angefangen, einige von denen, die mit DNN gearbeitet haben, seit dem Beginn auf einer stündlichen Basis für ein individuelles Training einzustellen (wie ich die Fragen stelle und sie beantworten sie nicht ein Klassenzimmer mit einem "vorgefertigten" Kurs). Die meisten Sites, die Module verkaufen, haben auch Foren, und diese Entwickler werden auch aus dem Weg gehen, um anderen zu helfen.
In kurzer Zeit und Ausdauer wird sich wie bei jedem anderen Framework oder Sprache auszahlen. Und wie Mitchel bemerkte "Du kannst mehr Fliegen mit Honig als mit Essig fangen"
Übrigens war da etwas Besonderes, nach dem Sie gesucht haben?
Die DotNetNuke-Benutzerhandbücher sind jetzt online hier verfügbar. Ich glaube, dass ein Update für 5.5.0 bald kommt.
Als jüngstes Mitglied des DotNetNuke Corp.-Entwicklungsteams (ungefähr 2 Monate) kann ich Ihnen versichern, dass es keine geheime API-Dokumentation gibt. Ich habe eine Kopie der gleichen API-Dokumente, die auf Codeplex sind. Es ist keine Überraschung, dass die API-Dokumentation begrenzt ist. Die überwiegende Mehrheit von DNN wurde von freiwilligen Entwicklern geschrieben, die lieber Code schreiben als Kommentare schreiben. Dieses Problem ist bei Open-Source-Projekten nicht selten. Mein einziger Vorteil gegenüber dem Rest der DNN-Entwickler-Community ist der einfache Zugang zu einigen der langjährigen Kern-Teammitglieder, die wissen, wie die Dinge funktionieren sollen.
Es gibt ein Projekt, um die API-Dokumentation zu erweitern, die DNN-Corp beteiligt sich und wie immer wird der Beitrag der Gemeinschaft sehr gefördert. Ernst Peter Tamminga hat kürzlich darüber gebloggt hier .
Ich bemerkte dies vor einem Jahr (wie wahrscheinlich durch meine SO-Geschichte belegt).
Um diese Leere zu füllen, las ich die großen roten Bücher und sah mir viele, viele Trainingsvideos an. Ich bin jetzt in Jahr 2 eines ziemlich großen Projekts; ~ 50 benutzerdefinierte DNN-Module und zwei DNN Core-Änderungen: Speedy URL Rewriting-System (über die Kapazität von URLMaster hinaus) und benutzerdefinierter 404/301-Handler.
Meiner Meinung nach, lesen Sie die Bücher, finden Sie einige Trainingsvideos, die Sie mögen, und Sie werden sehr schnell unterwegs sein. Es dauerte ein paar Monate, bis ich mich bei DNN-Modulen (die auf einen Client ausgerichtet waren) und DNN-Kernänderungen wohl fühlen konnten. Nachdem ich das gesagt hatte, hatte ich nach ein paar Wochen ein paar grobe Module.
Wenn das alles nicht gut klingt, stellen Sie Ihre Fragen hier auf SO - es gibt genug von der Community hier, dass es eine ziemlich gute Ressource ist.
Ich glaube, dass sie den Kerncode nicht absichtlich öffentlich dokumentieren, weil sie nur wollen, dass Sie innerhalb der Beschränkungen des Systems arbeiten, das sie für das Erstellen von Modulen bereitstellen, wie sie im Modulerstellungsleitfaden dokumentieren. Sie ermutigen Sie daher, den Kerncode als privat zu betrachten. Ich habe das in der Vergangenheit mit anderen CMS-Programmen gesehen.
Wenn ich nach öffentlichen API-Aufrufen in DotNetNuke suche, verwende ich .NET Reflector. Wenn du es vorher noch nicht benutzt hast, denke ich, dass es genau das ist, wonach du suchst (oder mehr). Sie können nach Klassen, Methoden und Eigenschaften suchen. Sie können die Suche mit DotNetNuke voranstellen, um Nicht-DNN-Inhalte herauszufiltern. Wenn Sie etwas finden, das richtig aussieht, können Sie den genauen Code anzeigen. Es ist kostenlos und Sie müssen sich keine Sorgen darüber machen, dass es nicht mehr aktuell ist, da Sie immer auf die neueste DNN-DLL verweisen können.
Tags und Links c# dotnetnuke