J'ai une difficulté avec une déclaration sur les pages DotNetNuke à propos de La documentation n'est disponible que lorsque vous payez 2 000 $ ou plus pour une licence professionnelle ou supérieure. Les forums sont inondés de questions, de nombreux dupliqués, Beaucoup d'investissements , malgré le travail acharné de la communauté DNN à suivre la demande.
J'ai essayé les livres, mais ils n'ont pas fourni les réponses que j'ai recherchées non plus et tandis que l'enthousiasme des écrivains est clair, l'impression verbeuse des grands exemples de plaque de chaudière et le manque d'informations ou de couverture de nouvel introduction Les mots-clés ne m'ont pas donné la compréhension plus profonde que je aspirais comme un développeur de module.
D'une part, je me sens à propos de DotNetNuke comme un endroit idéal pour être, mais d'autre part, chaque fois que j'ai besoin de cette un-doublon d'informations sur une méthode, je finis par la chercher depuis des siècles et Traversez le code et l'ingénierie inverse est alors mon meilleur ami.
Je suis curieux, pourquoi un produit existe-t-il depuis si longtemps, si mal documenté sur le comte de l'API? Après tout, il y a une société commerciale assez grande derrière elle et elle prospère par l'extensibilité du produit. Suis-je correct de comprendre que vous obtenez seulement cette documentation si vous payez chèrement? Ou les sociétés de développement de module ont-elles un accès spécial?
7 Réponses :
Je pense qu'ils ne documennent pas publiquement le code de base exprès, car ils ne veulent que de travailler dans les contraintes du système qu'ils fournissent pour la création de modules, car ils documentent dans le guide de création de module. Ainsi, ils vous encouragent à considérer le code de base comme privé. J'ai vu cela avec d'autres logiciels CMS dans le passé.
Les classes considèrent comme portastales une partie du noyau, mais elles ne sont pas documentées. Bien entendu, les contraintes du cadre doivent être obéi, bon point, mais les méthodes publiques sont là pour être utilisées par les développeurs de modules. Comment voudriez-vous savoir, dites-vous, obtenez le fournisseur de connaissement actuel? Mais le portambodulebasebasebasebase *. DNN Fichiers XML ...
Pour le moment, je vais éviter le ton argumentatif qui est probablement piloté vers le style d'écriture de mon livre et vous donner quelques indications à ce sujet.
La documentation API est disponible, bien que d'une véritable perspective de l'API, la documentation n'est pas encore à 100%. L'équipe de référence DotNetNuke s'emploie à améliorer la qualité de cette documentation, mais comme vous pouvez l'imaginer, cela va prendre beaucoup de temps pour obtenir quelque chose qui n'a pas eu beaucoup, le cas échéant, de la documentation de l'API à intégralement documenté, mais c'est la but final.
Les livres qui sont là-bas en ce moment sont une partie de la meilleure documentation globale sur le développement du DNN, mais elles ne couvrent qu'une certaine partie du processus. Par exemple, mon livre possède l'un des seuls articles qui documentent le nouveau format manifeste DNN 5.x, mais que le livre est sorti depuis plus d'un an, des articles ont été ajoutés au manifeste qui ne sont pas couverts dans le livre.
DotNetNuke Corporation tente d'améliorer la qualité et la disponibilité de la documentation en créant le nouveau projet wiki et en créant la documentation de l'API à priser, mais c'est un processus étape par étape.
Mais pour finir cela, permettez-moi de vous donner un bref conseil, il y a beaucoup d'entre nous dans la communauté DotNetNuke qui abaissent nos mégots pour aider les autres à comprendre le DNN et à passer tout le temps que nous faisons ici sur Stackoverflow, DotNetNuke.com, et même nos forums personnels. Si vous prenez un peu moins d'une approche argumentative, vous pourriez obtenir de meilleures réponses, et au minimum, vous ne courrez pas le risque d'irritant des personnes qui peuvent vraiment répondre à vos questions.
Bonjour @Mitchell: Merci d'avoir pris le temps de répondre. Mes excuses sur l'approche argumentative: le site indique que si vous payez, vous obtenez une documentation complète, c'est ce qui est frustré. Je suis parti plusieurs fois plusieurs questions (totalement neutre) sur les forums DNN et dans quelques cas, j'ai reçu des réponses. Je finis habituellement là-bas après que toutes les autres ressources ont été épuisées et que j'ai envie de frapper un mur blanc (amical). Je suis heureux que le travail sur la documentation de l'API soit en cours, en réalité: je me félicite beaucoup! Peut-être que je peux aider, je vais regarder.
Une petite note sur votre livre, mais peut-être que cette discussion est mieux adaptée ailleurs. Je l'ai acheté pour aider au développement du module, mais malheureusement - et je suis désolé de dire - cela n'a pas répondu aux questions que j'avais et les exemples fournis manquent d'une couverture profonde. Un exemple sur ma petite rancune avec l'index: essayez juste de trouver un mot clé manifeste, comme SupportPartialRending . Ce n'est pas là. En traversant la page de livre par la page, je l'ai trouvée. Essayez Rôles : Cela ne pointe pas les pages sur le rôle proventaire et ce dernier n'est pas non plus là. Mais en toute honnêteté, votre livre m'a également sauvé à quelques reprises;)
@Abel - croyez-moi, je comprends! J'étais la même chose qu'il y a 4 ans, alors que j'ai commencé avec DNN, et il y avait beaucoup moins de documentation alors. Le problème de l'indice est quelque chose que je suis très intéressé, car je n'ai pas réellement créé l'index et que vous n'êtes pas la première personne à me plaindre. Je crois aussi qu'un livre de plongée beaucoup "plus profond" est nécessaire sur le développement du module DotNetNuke, mais je ne sais pas si cela aura suffisamment de soutien pour aller de l'avant.
@Mitchell: Je serai heureux d'aider et de relire, mais des livres plus profonds prennent beaucoup de temps pour écrire et mûrir (voir Skeet Jon, combien de temps ses excellents livres ont pris et prennent encore).
Bien qu'il manque une documentation facilement obtenue qui explique l'API dans des détails pouvant répondre à vos besoins et normes immédiats, car Mitchel States DNN a l'une des meilleures "communautés" des concepteurs et des développeurs qui sortent de leur chemin s'aider les uns les autres.
Il existe de nombreux livres qui sont rédigés dans le but d'obtenir un programmeur ou une personne d'esprit d'esprit avec DNN, bien qu'ils puissent ne pas vous donner le détail que vous recherchez dans un domaine particulier, je suis sûr qu'il n'y en a pas un Auteur qui ne ferait pas de mieux pour répondre à une question qui n'a pas été répondu après avoir lu le livre si vous les avez contactés. Il existe de nombreux blogs et sites Web remplis d'informations et de forums avec des personnes qui partagent volontiers leurs connaissances avec ceux qui tentent d'apprendre. Je suis allé la racine de l'embauche de certains de ceux qui travaillaient avec DNN depuis le début sur une base horaire pour une formation personnalisée (comme dans je pose aux questions et qu'ils ne leur répondent pas non à une salle de classe avec un cours «prédéfiné»). La plupart des sites qui vendent des modules ont également des forums et ces développeurs vont également sortir du moyen d'aider les autres à apprendre.
Peu de temps et de persévérance paiera comme avec tout autre cadre ou langue. Et comme Mitchel noté «Vous pouvez attraper plus de mouches avec du miel qu'avec le vinaigre '
Au fait, c'était là quelque chose en particulier que vous recherchiez?
Vous soulevez un bon point. Normalement, je serais très hésitant à contacter des auteurs ou des développeurs de produits Open Source principaux, en considérant qu'ils ont de meilleures choses à faire avec leur temps. D'autre part, si je ne demande pas, ils ne sauront jamais qu'il y a une question. J'ai enlevé le vinaigre, mais ce n'est pas encore chérie;)
Je pose une deuxième réponse ici comme avec la question révisée Il existe une manière tout à fait différente de regarder les choses.
En ce qui concerne le manuel d'utilisation de DotNetNuke Professional Edition, je pense qu'il est très important de comprendre exactement ce que le manuel est. Ce n'est pas un guide des développeurs ou une documentation API, il s'agit de la documentation de l'interface utilisateur. Comment ajouter une page, comment ajouter un module à une page, comment installer une peau, des choses de cette nature. Oui, ce livre est une "fonctionnalité PE", juste mal ou indifférent cependant, il ne va pas aider un développeur avec la compréhension de la plate-forme DotNetNuke.
Je pense que c'est une distinction importante, car réellement le jeu de caractéristiques PE est conduit vers des implémentations commerciales, pas nécessairement une mise en œuvre des développeurs. L'ensemble du mouvement pour améliorer la documentation du développeur et la fonctionnalité des développeurs est dicté par la communauté et pas nécessairement les clients PE.
Il y a aussi d'autres raisons à cela, PE vient avec quelques modules récemment acquis par DotNetNuke Corporation, ces modules doivent également avoir une documentation, ce que je devine est une autre partie du document de l'interface utilisateur référencée par votre lien dans le poteau.
Quant aux forums, oui, je suis d'accord qu'ils peuvent être frustrants. C'est l'une des raisons pour lesquelles les forums sur mon site ( http://www.mitchelsellers.com ) sont fréquenté comme ils obtiennent une très meilleure exposition. Un autre élément qui pourrait être idéal pour la communauté est mon a récemment proposé DotNetNuke StackeSchange Site . Si vous ne l'avez pas déjà fait, je sortirais et montrerais votre soutien!
Dans l'ensemble, je ressens votre douleur, j'ai été membre actif de la communauté DotNetNuke depuis plus de 4 ans maintenant, et cela peut parfois être difficile, mais à la fin, cela en vaut toujours la peine.
+1 Encore une fois, cela rend les choses un peu plus compréhensibles et je n'étais pas au courant des autres forums, je vais bien regarder. (Je vais changer de réponse acceptée, je crois que celui-ci répond à mon original vaut mieux, même si mon original Q. Était mal et trompeusement libellé de manière erronée).
Les manuels d'utilisation DotNetNuke sont maintenant disponibles en ligne ici . Je crois qu'une mise à jour pour 5.5.0 arrive bientôt.
En tant que membre le plus récent de l'équipe de développement DotNetNuke Corp. (environ 2 mois maintenant), je peux vous assurer qu'il n'y a pas de documentation d'API secrete. J'ai une copie des mêmes documents API qui sont sur CodePlex. Il n'est pas surprenant que la documentation de l'API soit limitée, la grande majorité des DNN a été écrit par des développeurs de volontaires qui préfèrent coder que d'écrire des commentaires, ce problème n'est pas rare des projets open source. Mon seul avantage sur le reste de la communauté des développeurs DNN est un accès facile à certains des membres de l'équipe principale de longue date qui savent comment les choses sont censées fonctionner.
Il existe un projet pour étendre la documentation de l'API en cours, DNN CORP participe et comme toujours une contribution communautaire est très encouragée. Ernst Peter Tamminga a le bloguage à ce sujet récemment
+1, c'est un bon ajout à cette discussion et je suis heureux d'entendre que la référence reçoit de plus en plus d'attention.
Lorsque je recherche des appels d'API publics dans DotNetNuke, j'utilise le réflecteur .NET. Si vous ne l'avez pas utilisé auparavant, je pense que cela pourrait être exactement ce que vous recherchez (ou plus). Il vous permet de rechercher des cours, des méthodes et des propriétés. Vous pouvez préférer la recherche avec DotNetNuke pour filtrer des trucs non-DNN. Lorsque vous trouvez quelque chose qui semble bien, cela vous permet d'afficher le code exact. C'est gratuit et vous n'avez jamais à vous soucier de sortir de la date, car vous pouvez toujours faire référence à la dernière DNN DLL.
Le réflecteur vous permet d'inverser l'ingénieur un assemblage compilé. Bien que cela soit extrêmement utile (et la version enregistrée vous permet de déboguer à travers l'assemblage décompilé) et pendant que cela m'a sauvé de nombreuses heures, même avec des assemblages BCL, il n'est pas substitut à une bonne documentation.
J'ai remarqué que ceci il y a un an (comme étant probablement mis en évidence mon histoire afin).
partiellement pour remplir ce vide, j'ai lu les grands livres rouges et j'ai regardé beaucoup de vidéos de formation. Je suis maintenant en première année d'un projet plutôt important; ~ 50 modules DNN personnalisés et deux changements de noyau DNN: système de réécriture de l'URL rapide (au-delà de la capacité de l'URLMaster) et du gestionnaire 404/301 personnalisé.
À mon avis, lisez les livres, trouvez quelques vidéos de formation que vous aimez et vous serez sur votre chemin très rapidement. A pris quelques mois pour vous sentir confortable des modules DNN (ciblés sur un client) et modifier le noyau DNN. Avec cela dit, j'ai eu quelques modules bruts fonctionnant après quelques semaines.
Si rien de tout cela ne semble bon, posez simplement vos questions ici. Il y a suffisamment de la communauté ici que c'est une assez bonne ressource.
@closers: ok, je comprends que j'utilise un libellé subjectif, mais la question: "Puis-je voir la documentation lorsque j'ai une édition professionnelle ou où dois-je regarder pour commencer?" est un Question valable, n'est-ce pas? Bien sûr, je, et beaucoup de mes collègues, sont souvent frustrés par l'absence de documentation à jour de DNN.
Le manque de documentation est souvent un problème de projets open source. Il est amusant d'écrire du code, moins de personnes pensent que c'est amusant d'écrire une documentation pour cela.
Livres: DotNetNuke.com/support/documentation/dotNetNukebooks/tabid/ 1 334 / ...
@Hans: Outre les livres débutants, je les possède tous. Le mieux qu'ils font est de vous montrer beaucoup de code de modèle. La plupart des informations, même si les livres ciblent 5.0, sont obsolètes, incorrectes ou si incomplètes qu'il est inutilisable dans la pratique. Si vous prenez le temps de les lire du couvercle pour couvrir, vous pouvez trouver des informations utiles (mais conservez des notes, l'index ne vous aidera pas à le retrouver ...)
@Driis: Eh bien, DotNetNuke est partiellement open source, mais est également un produit hautement commercial qui coûte des milliers de dollars. Est-ce que le $$$ achète-vous la documentation? Je le dépenserais volontiers si seulement je savais que j'avais un meilleur soutien.
Mitchel Vendeurs publient ici. Envoyez-lui un email pour le diriger vers votre question ici. Stackoverflow.com/users/13279/Citchel-sellers
@Hans: Merci, je n'étais pas au courant de cela. Je viens de lui envoyer un message.
Bonjour Abel, je travaille aussi avec DNN et vous pouvez également m'envoyer directement des courriels sur vos problèmes. Je vais essayer de vous guider correctement, car je suis aussi un développeur travaillant avec DNN depuis 4.x