I am a HUGE fan of CodeProject, and very appreciate of the website. For my purposes, I consider it one of the most valuable resources on the Internet. Thanks!
Several things would be helpful and often missing for many articles, especially those which involve algorithms:
* Console app using the algorithm. I find these MUCH easier than gui's to figure out with a debugger to step-into and step-around.
* Extensive, even exhaustive tests to provide a high degree of confidence that the submitted code actually works. I REALLY want to reuse their code and not "re-invent" the wheel, but I really often wonder how "bullet-proof" the code is.
* I looked on the website for "Guidelines for Authors when Submitting Articles" but perhaps didn't look hard enough.
EDIT ... found the webpage for Authors ... but would suggest those guidelines put more emphasis on providing test code
For example, I'm trying to reuse some submitted code related to tokenizing. I found several applicable articles. It would be VERY valuable for the demo code to have something like the following to show that the code has been rigorously tested:
char* testStringsWithTokens[] = {
"a", "1 <1 a>",
"a b c", "3 <1 a><1 b><1 c>",
" a b c ", "3 <1 a><1 b><1 c>",
"one two three", "3 <3 one><3 two><5 three>",
"one\ttwo\tthree", "3 <3 one><3 two><5 three>",
"one,two,,,, ,,, three,,,", "3 <3 one><3 two><5 three>",
" one two three", "3 <3 one><3 two><5 three>",
" one\ttwo\tthree", "3 <3 one><3 two><5 three>",
" one,two,,,, ,,, three,,,", "3 <3 one><3 two><5 three>",
" one two three ", "3 <3 one><3 two><5 three>",
" one\ttwo\tthree ", "3 <3 one><3 two><5 three>",
" one,two,,,, ,,, three,,, ","3 <3 one><3 two><5 three>",
"one two three ", "3 <3 one><3 two><5 three>",
"one\ttwo\tthree ", "3 <3 one><3 two><5 three>",
"one,two,,,, ,,, three,,, ", "3 <3 one><3 two><5 three>",
};
I realize that it isn't CodeProject's responsibility to see that such test code is included, and I'm VERY appreciative for what is available .... but the authors who presumably want their code to be reused are perhaps less aware that they could be of the value of cppunit-like test code ....
Again, thanks.
-- modified at 17:40 Tuesday 28th February, 2006
|