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.

Announcing the DNN Documentation Center


Microsoft has always been viewed as a developer friendly company.  Almost every product they build is extensible and includes in-depth documentation. All of this documentation is maintained in the Microsoft Developer Network (MSDN), which is one of the premiere developer documentation centers in the world.

Since DNN was first created, thousands of pages of documentation and hundreds of videos have been created. Much of this documentation is available at various locations on and in a few external sites. Documentation is available as help files, pdfs, wiki articles, blog posts, videos and PowerPoint slide-decks. Unfortunately, it is not always easy to find the information you are looking for, and when you do find it, it is not always clear if the documentation is up to date.


Finding the right tool

Last fall we decided that it was time to start consolidating all of our documentation efforts in one location. As part of this effort we looked at many different documentation systems to find one that could handle the wide variety of documentation formats we need to support. We identified the following key features:

  • multiple output formats (e.g. HTML, PDF, ePub)
  • multiple device formats (e.g. desktop, tablet, phone)
  • support multiple products (platform and Evoq) and product versions
  • allow community feedback and contribution
  • open content format (no commercial software needed to create documents)
  • extensible and templatable

After looking at many different options, we finally settled on the Sphinx Documentation Generator.  Sphinx is an open source system created by the Python community for their own documentation efforts, and is built using reStructuredText markup format and the Jinja template engine.

Although Sphinx started as a Python documentation tool, it includes support for documenting many different programming languages and has since spread to other development communities. This tool was also recently chosen by the ASP.NET team for documenting ASP.NET Core.

the Documentation Center

Having chosen our documentation system, we started creating new documents to populate the documentation center. With so much existing documentation it would be easy to get overwhelmed with the shear magnitude of effort required to convert everything to the new format and move it to the documentation center. Some of the existing documentation is outdated and won’t be moved.  Additionally, there are some portions of the system that were undocumented.

For the initial release of the documentation center we have focused on getting a framework in place with some baseline documentation. The documentation center includes articles to help you get started with DNN, some initial how-to documents, some high-level conceptual information, and links to existing documentation. For the immediate future, the documentation center will serve as a hub while we continue the migration effort.

I am proud to announce that the DNN Documentation Center is now live. The documentation center is intended to serve all of our users; whether you are a developer, administrators or designer, there is documentation available for you.


Community Effort

We still have a lot of work left to accomplish this year and we could use your help. You can find the documentation source documents on GitHub. If you find a problem with the documentation, enter an issue in the GitHub issue tracker or submit a Pull Request. With your help we can accelerate conversion of the existing documentation and improve the overall quality of the DNN and EVOQ documentation.



I admire your hard work at DNN Corp. I do not have a professional need for a CMS (yet); I just enjoy experimenting with them. This time I'm sticking with DNN because, in my opinion, you guys are always on the bleeding edge (and because my Dell Edge handles DNN 8 pretty smoothly, unlike last time, a few years back, when I gave up prematurely because my Windows 7 machine did not provide a pleasant experience).

Thank you and your team for giving us DNN! When can we expect the book to come out?
domyorker Tuesday, March 01, 2016 8:59 PM (link)

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 (21)
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 (269)
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?