Game Development Community

1.1.3 New Doc Impressions

by Matthew Langley · in Torque Game Builder · 11/30/2006 (9:11 am) · 6 replies

Hey everyone. Well now that 1.1.3 is out and the new Documentation Framework was out I was curious on any input back from people, good, bad, or nuetral.

This is the first time the system is getting hammered by many users so any bug reports you can post in the bug reports forum (be sure to tag it with "Doc Framework").

Also any suggestions would be appreciated as well. There are still some more things that might be added though would be interested to hear what everyone would like to be added and/or changed.

#1
11/30/2006 (10:32 am)
I really love it.. that's an example documentation any tool creator should have a look at. Hopefully the TGE team will follow your example. :)

Under "Online Resources" I read TGB book but I got forwarded to the TGE book I already own. Does that mean there is a TGB one in the plans or is that an accident?
#2
11/30/2006 (11:08 am)
I'll 2nd Oliver's comments, this is much less fiddly then the pdf's (previously having to move from 1 to the next) as good as they were! Loving the align tool and text object too.
Quote:I really wish this amount of attention and detail was given to TGE.
You guys better be careful though, as you can see from the above, your gonna make the non TGB and newb TGE core users jealous, seriously! LOL ;0)
#3
11/30/2006 (11:18 pm)
I love the new docs very much and hopefully other products also use this new doc framework.

I also report some minor bugs here
#4
12/03/2006 (4:14 am)
I like them, they're nicer then the pdf's, although theres random words highlighted all over the place as keywords, but they dont do anything, and it is a little slow loading at first, but then it is fine.

Anyways, thanks for the update
#5
12/03/2006 (8:00 am)
It's way better than before, gratz ^^

But, I still miss a true tutorial for using sounds (spatial sounds, not only simple playback and stop).
#6
12/10/2006 (6:45 am)
It's a good ressource !

setPathRotationOffset is missing maybe some other functions too ?

Now that help come in HTML maybe we could have a CHM (linked with the TGB reference button inside TGB IDE) so research could be much faster and clear.
I like the way tips open inside the tutorial. Maybe some function could have examples which open the same way.

The complete reference page take a little bit too much time to load.
Maybe it would have be more efficient to have every command in a separated xml file, with diferent tags so external IDE could easily grab what's needed (function definition, code completion, tips, help, examples,...), loading/searching time would have been shorter and list of all functions grouped by genre would have benefit of a better layout than folder.