Learn More





DNN Community Blog

The Community Blog is a personal opinion of community members and by no means the official standpoint of DNN Corp or DNN Platform. This is a place to express personal thoughts about DNNPlatform, the community and its ecosystem. Do you have useful information that you would like to share with the DNN Community in a featured article or blog? If so, please contact .

The use of the Community Blog is covered by our Community Blog Guidelines - please read before commenting or posting.

Reference Team Developer API Work

Earlier this year I was made a member of the DotNetNuke core team, and with this designation I have been able to help make some of the changes that I have been encouraging over the past few years.  Since the new DotNetNuke core team structure was identified teams within the core have been established to help create smaller groups that can more easily tackle specific deliverables.  I jumped at the opportunity to work on the "Reference" team which was created to work on reference materials and documentation.

The first deliverable that I have been working on with the support of Cathal and the others is to improve the quality of the DotNetNuke Developer API and the way that its information can be used to support the developer community.  People may be familiar with the efforts that Ernst Peter has put into the "DNN Help System" project on codeplex, which is part of what we are working to incorporate into a truly supported system that comes out of the core team.  The following is a listing of the different goals/actions that we will be working on, future blog posts will be completed by myself or Cathal as we start rolling out the actual implementation of these items.

1. Provide a download with Visual Studio Intellisense files

One common limitation when working as a developer within the DotNetNuke environment is that Intellisense support is not something that is readily visible for developers.  Although easy to get intellisense support by simply compiling the core, and copying the generated xml files, starting with the 5.2.x releases DotNetNuke corporation will be publishing the xml intellisense files as a separate download.  This will allow developers to easily copy the xml files along-side their DotNetNuke.dll file and they will then have intellisense support within Visual Studio for all custom development activities.

At this time, most core API methods have at minimum a "summary" description which will add value for the intellisense support.

2. Provide a Hosting Location within DotNetNuke's Website

The first thing we are going to do is to make the creation of the compiled HTML documentation a regular process and establish a location for an online copy to be made available.  This will be done in a manner that will be very similar to MSDN style documentation and will be updated as we continue to improve the quality of documentation. 

The exact publish location of this information has yet to be identified, but within the next few weeks as we continue to improve the quality of documentation we will make the official announcement when the information is available.

3. Improve the quality of existing internal documentation

Starting with the initial release of documentation with item #2 above, we will start working to improve the quality of the API documentation.  With the initial release we will be fully documenting one class within the API, the UserController class.  This will be done to show the new standard of documentation that will be targeted for all core API code.  Once we have established the standards the team will work quickly to continue commenting the rest of the code and publishing updated documentation files as soon as possible.

This updated documentation will include improved summary comments as well as full sample code where applicable to ensure that proper use of methods is documented and readily available.

So, stay tuned to the blogs here on as we start to roll out the first deliverables from the Reference team.


Comment Form

Only registered users may post comments.


2sic Daniel Mettler (124)
Aderson Oliveira (15)
Alec Whittington (11)
Alex Shirley (10)
Andrew Nurse (30)
Anthony Glenwright (5)
Antonio Chagoury (28)
Ash Prasad (22)
Ben Schmidt (1)
Benjamin Hermann (25)
Benoit Sarton (9)
Beth Firebaugh (12)
Bill Walker (36)
Bob Kruger (5)
Brian Dukes (2)
Brice Snow (1)
Bruce Chapman (20)
Bryan Andrews (1)
cathal connolly (55)
Charles Nurse (163)
Chris Hammond (203)
Chris Paterra (55)
Clinton Patterson (28)
Cuong Dang (21)
Daniel Bartholomew (2)
Dave Buckner (2)
David Poindexter (3)
David Rodriguez (2)
Doug Howell (11)
Erik van Ballegoij (30)
Ernst Peter Tamminga (74)
Geoff Barlow (6)
Gifford Watkins (3)
Gilles Le Pigocher (3)
Ian Robinson (7)
Israel Martinez (17)
Jan Blomquist (2)
Jan Jonas (3)
Jaspreet Bhatia (1)
Jenni Merrifield (6)
Joe Brinkman (270)
John Mitchell (1)
Jon Henning (14)
Jonathan Sheely (4)
Jordan Coopersmith (1)
Joseph Craig (2)
Kan Ma (1)
Keivan Beigi (3)
Ken Grierson (10)
Kevin Schreiner (6)
Leigh Pointer (31)
Lorraine Young (60)
Malik Khan (1)
Matthias Schlomann (15)
Mauricio Márquez (5)
Michael Doxsey (7)
Michael Tobisch (3)
Michael Washington (202)
Mike Horton (19)
Mitchel Sellers (28)
Nathan Rover (3)
Navin V Nagiah (14)
Néstor Sánchez (31)
Nik Kalyani (14)
Peter Donker (52)
Philip Beadle (135)
Philipp Becker (4)
Richard Dumas (22)
Robert J Collins (5)
Roger Selwyn (8)
Ruben Lopez (1)
Ryan Martinez (1)
Salar Golestanian (4)
Sanjay Mehrotra (9)
Scott McCulloch (1)
Scott S (11)
Scott Wilkinson (3)
Scott Willhite (97)
Sebastian Leupold (80)
Shaun Walker (237)
Shawn Mehaffie (17)
Stefan Cullmann (12)
Stefan Kamphuis (12)
Steve Fabian (31)
Timo Breumelhof (24)
Tony Henrich (3)
Torsten Weggen (2)
Vicenç Masanas (27)
Vincent Nguyen (3)
Vitaly Kozadayev (6)
Will Morgenweck (37)
Will Strohl (163)
William Severance (5)
Try Evoq
For Free
Start Free Trial
a Demo
See Evoq Live
Need More Information?