Suggestion: Tutorial Code Documentation Examples
by Alex Mickus · in Torque Game Builder · 03/24/2008 (10:45 pm) · 2 replies
I'm very new to Torque Game Builder and I've noticed an issue in the documentation of the tutorials. Often, the tutorial explanation includes a "this is what your code should look like" at the end of each section in the tutorial. This is most helpful as you have the final product of what your code/script should look like. So at the very least, you can copy and paste the script from the tutorial into your own text files. This enables you to press "play scene" and run your game.
The problem is not all of the tutorials have the final example code for each section. I personally spent many hours debugging part of the Fish Game tutorial because I didn't have an example code in the documentation to compare it with. This happens specifically in "Torque Game Builder - Fish Game Tutorial - Part 4. Adjusting Movement" where there is no final code example that the user can look at.
Don't forget that many people who are trying out this product may in fact be novices and could be very confused by all of the code they have to copy and paste in each tutorial section. I think it would be most helpful if all of the TBG Tutorials included the final example code of the current section displayed at the end of each segment of documenation, as a standard convention for the tutorial writers to follow.
Thanks :)
-Alex
The problem is not all of the tutorials have the final example code for each section. I personally spent many hours debugging part of the Fish Game tutorial because I didn't have an example code in the documentation to compare it with. This happens specifically in "Torque Game Builder - Fish Game Tutorial - Part 4. Adjusting Movement" where there is no final code example that the user can look at.
Don't forget that many people who are trying out this product may in fact be novices and could be very confused by all of the code they have to copy and paste in each tutorial section. I think it would be most helpful if all of the TBG Tutorials included the final example code of the current section displayed at the end of each segment of documenation, as a standard convention for the tutorial writers to follow.
Thanks :)
-Alex
#2
I believe that you learn by doing, not by pasting. :)
Then you also have a chance to debug your typos and semicolons you left off, etc. It's a much more "natural" coding process, in my opinion.
05/21/2008 (4:10 pm)
I know this won't be much help, but I always type out the code manually instead of copying and pasting.I believe that you learn by doing, not by pasting. :)
Then you also have a chance to debug your typos and semicolons you left off, etc. It's a much more "natural" coding process, in my opinion.
Torque Owner Alex Mickus
Anyone know if there's a way to disable the onmouseover text? Also, what is the purpose of having so much of the example code formatted this way?
-Alex