Является ли документация DotNetNuke действительно в значительной степени недействительной или она доступна только в коммерческих изданиях?
У меня возникли трудности с заявлением на страницах DotNetNuke о том, что документация доступна только тогда, когда вы платите 2000 долларов или больше за профессиональную или более высокую лицензию. Форумы наводнены вопросами, многие продублированы, многие остались без ответа , несмотря на тяжелую работу сообщества DNN, чтобы не отставать от спроса.
Я попробовал книги, но они не сделали » Я не смог найти ответы, которые я искал, и хотя энтузиазм авторов ясен, многословная печать больших примеров и нехватка информации или охват недавно введенных ключевых слов не дали мне более глубокого понимания, к которому я стремился как Разработчик модуля.
С одной стороны, я чувствую, что DotNetNuke - отличное место для жизни, но с другой стороны, каждый раз, когда мне нужна одна строка информации о методе, я в конечном итоге ищу его возраст, и пошаговое выполнение кода и обратный инжиниринг - мой лучший друг.
Мне любопытно, почему продукт, который существует так долго, так плохо документирован на счет API? В конце концов, за этим стоит довольно крупная коммерческая компания, которая процветает благодаря расширяемости продукта. Правильно ли я понимаю, что вы получаете эту документацию, только если платите дорого? Или у компаний, занимающихся разработкой модулей, есть особый доступ?
4 ответа
Я публикую здесь второй ответ, так как с исправленным вопросом есть совершенно другой взгляд на вещи.
Что касается руководства пользователя для профессионального издания DotNetNuke, я думаю, очень важно, чтобы вы точно понимали, что это за руководство. Это НЕ руководство для разработчиков или документация по API, это документация по пользовательскому интерфейсу. Как добавить страницу, как добавить модуль на страницу, как установить скин и тому подобное. Да, эта книга является «Особенностью PE», но она не поможет разработчику понять платформу DotNetNuke.
Я думаю, что это важное различие, поскольку на самом деле набор функций PE ориентирован на бизнес-реализации, а не обязательно на реализацию разработчиками. Все движение по улучшению документации для разработчиков и функциональности для разработчиков управляется сообществом, а не обязательно пользователями PE.
Для этого есть и другие причины, PE поставляется с несколькими модулями, которые недавно были приобретены корпорацией DotNetNuke, эти модули также должны иметь документацию, которая, как я предполагаю, является другой частью документа пользовательского интерфейса, на который ссылается Ваша ссылка внутри поста.
Что касается форумов, да, я согласен, они могут раздражать. Это одна из причин того, что форумы на моем сайте (http://www.mitchelsellers.com) часто посещаются, поскольку они получают немного больше информации. Еще один элемент, который может быть полезен сообществу, — мой недавно предложенный сайт DotNetNuke StackExchange.Если вы еще этого не сделали, я выйду и поддержу вас!
В целом, хотя я и чувствую вашу боль, я являюсь активным членом сообщества DotNetNuke уже более 4 лет, и временами это может быть непросто, но, в конце концов, оно того стоит.
На данный момент я избегаю спорного тона, который, скорее всего, направлен на стиль написания моей книги, и дам вам несколько советов по этому поводу.
Доступна документация по API, хотя с истинной точки зрения API документация еще не на 100%. Справочная группа DotNetNuke работает над улучшением качества этой документации, но, как вы можете себе представить, потребуется много времени, чтобы получить полностью задокументированную документацию по API. конечная цель.
Книги, которые сейчас доступны, являются одной из лучших общих документов по разработке DNN, НО они охватывают только определенную часть процесса. Например, в моей книге есть один из немногих элементов, документирующих новый формат манифеста DNN 5.x, но, поскольку книга существует уже более года, в манифест были добавлены элементы, не описанные в книге.
Корпорация DotNetNuke пытается улучшить качество и доступность документации, создав новый проект Wiki и обновив документацию по API, но это пошаговый процесс.
Но чтобы закончить на этом, позвольте мне дать вам небольшой совет: многие из нас в сообществе DotNetNuke рвут свои задницы, чтобы помочь другим понять DNN, и тратят все время, которое мы проводим здесь, на StackOverflow, DotNetNuke.com и даже наши личные форумы. Если вы будете использовать менее аргументированный подход, вы можете получить более качественные ответы, и, как минимум, вы не рискуете раздражать людей, которые действительно могут ответить на ваши вопросы вместо вас.
Я полагаю, что они намеренно не документируют основной код публично, потому что они хотят, чтобы вы работали только в рамках ограничений системы, которую они предоставляют для создания модулей, как они документируют в руководство по созданию модуля. Таким образом, они поощряют вас рассматривать основной код как частный. Я видел это с другим программным обеспечением CMS в прошлом.
Несмотря на отсутствие легкодоступной документации, подробно объясняющей API, которая может удовлетворить ваши насущные потребности и/или стандарты, как утверждает Митчелл, DNN имеет одно из лучших «сообществ» дизайнеров и разработчиков, которые стараются изо всех сил. помогать друг другу.
Существует множество книг, написанных с целью побудить программиста или специалиста по информационным технологиям работать с DNN, хотя они могут не дать вам подробностей, которые вы ищете в конкретной области. Я уверен, что нет ни одной. автор, который не сделал бы все возможное, чтобы ответить на вопрос, на который не ответили после прочтения книги, если бы вы связались с ним. Существует множество блогов и веб-сайтов, полных информации и форумов с людьми, которые охотно делятся своими знаниями с теми, кто пытается учиться. Я начал нанимать некоторых из тех, кто работал с DNN с самого начала, на почасовой основе для индивидуального обучения (например, я задаю вопросы, и они отвечают на них, а не в классе с «заранее разработанным» курсом). Большинство сайтов, которые продают модули, также имеют форумы, и эти разработчики также приложат все усилия, чтобы помочь другим учиться.
Вскоре и настойчивость окупится, как и в случае с любым другим фреймворком или языком.И, как заметил Митчел, «на мед можно поймать больше мух, чем на уксус»
. Кстати, было ли что-то особенное, что вы искали?