Last post Apr 27, 2006 11:12 AM by flanakin
Apr 25, 2006 06:46 AM|JohnStodd|LINK
I have just downloaded the "new" 4.0.3 docs, and find that all the documents are dated Dec 2005, and most of the changes seem to have been made in Aug 05!
Frankly it seems to me this is disappointing (sorry to grumble). There has been some excellent stuff posted in the forums about starter kits, building a module, installing clean version of DNN 4 etc, and yet the docs have never been updated. So new users
still make the same old mistakes, and fill these forums with the same old errors that tie up core members' time responding with the same answers.
Why is most of the best documentation scattered around blogs and forums and not in the basic manuals? Why is there not even a small readme.txt in the install and source zips?
Is it all being saved for 4.1? If so, that gives the signal that we should hold off 4.0.3 and wait...
Sorry to criticise.
Apr 25, 2006 03:19 PM|iwonder|LINK
The v4.0.3 version was really just a fix for folks having the caching issues and not a lot more. The doc would not be updated for the relatively small fixes presented. I think it was made available just as part of the standard release zips. Although, I'd
suggest the CT could probably do well to include a "Notes On The Release' type of document that could be a simple readme.txt type of doc, to mention what late breaking changes the release is fixing and any relevant news regarding updates to the project itself
at time of this release. That would be something easier to keep current with the release.
While it may be disappointing, the doc is always behind the info available in most other areas, not an excuse, but that's the way it is in the development cycle for a lot of web projects, not just DNN. I'd like to see the doc updated as well, but frankly,
if the code and community can be updated routinely, I don't worry so much about it.
You could hold off for DNNv4.1.0, if you don't have the caching issues, and you won't miss much.
Just my thoughts..
Apr 26, 2006 12:27 PM|flanakin|LINK
Apr 27, 2006 04:31 AM|JohnStodd|LINK
Apr 27, 2006 11:12 AM|flanakin|LINK
Well, first off, let me say that there are planned updates for the coming release. Second, the best place to put your change requests is Gemini. If you're explicit in what needs to be modified, these can typically be updated quicker. For instance, if you
say, in the install guide, page 4, paragraph 2, sentance 3, "...this is the sentance...", should be changed to, "...this is my revision..." Just make sure that you specify the bug is in the documentation.
Also, note that the QA team will be expanding soon. When this happens, some of these issues should start to be resolved. One of their first tasks is to start cleaning out Gemini.