DotNetNuke文档在很大程度上是无效的，还是仅在商业版中提供？

Question

如果您为专业或更高级别的许可证支付2000美元或更高的费用，我只能使用a statement on the DotNetNuke pages about the documentation。尽管DNN社区努力跟上需求，但论坛充斥着许多重复的问题many unanswered。

我已经尝试了这些书籍，但他们也没有提供我所寻找的答案，而且作者的热情很明显，大型锅炉板示例的冗长印刷以及缺乏新引入的信息或报道关键字并没有让我对作为模块开发人员的渴望有了更深刻的理解。

一方面，我觉得DotNetNuke是一个很棒的地方，但另一方面，每当我需要一个方法的单行信息时，我最终会找到它多年，踩过代码和逆向工程是我最好的朋友。

我很好奇，为什么一款产品已经存在了这么长时间，因此对API的数量记录不足？毕竟，它背后有一个相当大的商业公司，它因产品的可扩展性而蓬勃发展。我是否理解您只有付出高昂代价才能获得此文件？或者模块开发公司有特殊的访问权限吗？

Answer 1

我在这里发布了第二个答案，因为修改过的问题有一个完全不同的方式来看待事物。

关于DotNetNuke专业版用户手册，我认为您完全了解手册是非常重要的。它不是开发人员指南或API文档，而是用户界面文档。如何添加页面，如何将模块添加到页面，如何安装皮肤，这种性质的东西。是的，那本书是一个“PE功能”，但是错误或无关紧要，它不会帮助开发人员了解DotNetNuke平台。

我认为这是一个重要的区别，因为PE功能集实际上是推动业务实现，而不一定是开发人员实现。改善开发人员文档和开发人员功能的整个过程由社区推动，而不一定是PE客户。

还有其他原因，PE附带了一些最近被DotNetNuke公司收购的模块，这些模块也必须有文档，我猜测是另一部分被引用的UI文档你在帖子中的链接。

至于论坛，是的，我同意他们可能会感到沮丧。这是我网站上的论坛（http://www.mitchelsellers.com）经常光顾的原因之一，因为他们获得了更好的曝光率。另一个可能对社区有用的项目是我最近提出的DotNetNuke StackExchange site。如果你还没有这样做，我会出去表示你的支持！

总的来说，虽然我确实感受到了你的痛苦，但我已经成为DotNetNuke社区的活跃成员已有4年多了，而且有时会很艰难，但最终总是值得的。

Answer 2

目前，我将避免使用最有可能推动我书写风格的论证语气，并就此给出一些指示。

1. API文档可用，但从真正的API角度来看，文档还不是100％。 DotNetNuke参考团队正致力于提高本文档的质量，但正如您所想象的那样，需要很长时间才能获得没有太多（如果有的话）API文档需要完整记录的内容，但这就是最终目标。

2. 现在出版的书籍是关于DNN开发的最佳整体文档，但它们仅涵盖了流程的某个部分。例如，我的书中有一个记录新DNN 5.x清单格式的唯一项目，但由于该书已经出了一年多，所以清单中已添加了未在书中涵盖的项目。

3. DotNetNuke公司正在尝试通过创建新的Wiki项目并将API文档提升到鼻子来提高文档的质量和可用性，但这是一个循序渐进的过程。

但是为了完成这一点，让我快速给你一个建议，我们在DotNetNuke社区中有很多人为了帮助其他人了解DNN并花费我们在这里做的所有时间而垮掉我们的屁股StackOverflow，DotNetNuke.com，甚至我们自己的个人论坛。如果你采取一些较少的议论方法，你可能会得到一些更好的答案，至少你不会冒着激怒真正能为你回答问题的人的风险。

Answer 3

虽然缺乏易于获取的文档，可以详细解释API，可以满足您的直接需求和/或标准，因为Mitchel表示DNN拥有最好的设计师和开发人员“社区”之一互相帮助。

有很多书都是为了让一个程序员或有思想的人与DNN一起工作而写的，虽然他们可能不会在特定区域给你你想要的细节我相信没有一本如果您联系他们，那么在阅读本书之后无法回答未回答的问题的作者。有许多博客和网站充满了信息和论坛，人们愿意与那些想要学习的人分享他们的知识。我从一开始就按小时为基础聘请了一些与DNN合作的人员进行定制培训（就像在我问问题时他们回答的不是一个带有“预先设计”课程的课堂）。大多数销售模块的网站也有论坛，这些开发人员也会帮助其他人学习。

在短时间内，持久性将与任何其他框架或语言一样得到回报。正如米切尔所说，“你可以用蜂蜜捕获更多的苍蝇而不是醋”

顺便问一下，你有什么特别想要的吗？

Answer 4

DotNetNuke用户手册现已在线提供here。我相信5.5.0的更新即将推出。

作为DotNetNuke Corp.开发团队的最新成员（现在大约2个月），我可以向您保证，没有秘密的API文档。我有一份在codeplex上的相同API文档的副本。毫无疑问，API文档是有限的，绝大多数DNN是由志愿开发人员编写的，他们宁愿编写代码而不是编写注释，这个问题在开源项目中并不罕见。我对DNN开发者社区其他成员的唯一优势是可以轻松访问一些知道事情如何工作的长期核心团队成员。

有一个扩展API文档的项目正在进行中，DNN公司正在参与，并且一如既往地鼓励社区贡献。恩斯特·彼得·塔明明最近在博客上写了here。

Answer 5

一年前我注意到这一点（正如我的SO历史可能证明的那样）。

为了填补这个空白，我阅读了大红色书籍并观看了很多很多培训视频。我现在正处于一个相当大的项目的第二年; ~50个自定义DNN模块和两个DNN Core更改：Speedy URL重写系统（超出URLMaster的容量）和自定义404/301处理程序。

在我看来，阅读书籍，找一些你喜欢的培训视频，你很快就会上路。花了几个月的时间来安装DNN模块（针对一个客户端）并修改DNN核心。话虽如此，几周后我确实有一些粗略的模块正在运作。

如果这一切听起来不错，那么就在这里问你的问题 - 这里有足够的社区，这是一个非常好的资源。

Answer 6

我认为他们没有故意公开记录核心代码，因为他们只希望您在创建模块的系统限制范围内工作，因为他们在模块创建指南中记录。因此，他们鼓励您将核心代码视为私有代码。我以前用其他CMS软件看过这个。

Answer 7

当我在DotNetNuke中寻找公共API调用时，我使用.NET Reflector。如果您之前没有使用它，我认为它可能正是您正在寻找的（或更多）。它允许您搜索类，方法和属性。你可以用DotNetNuke作为搜索前序来过滤掉非DNN的东西。当您找到看起来正确的内容时，它可以让您查看确切的代码。这是免费的，你永远不必担心它会过时，因为你总是可以参考最新的DNN dll。