Official TGB Documentation Feedback

#41 Great docs - except for one thing: Many links there open in a new page. You shouldn't force navigation choices on users like that ;)
When I click them, my browser opens the page in just the default size, which isn't always wanted because of my high resolution. The pages I browse may be at 120% to 150% of the default.
I prefer to middle-click each interesting link to open a new tab in the background, and this keeps my preferred zoom level.

#42 @Ronny - Thanks. Yeah, that was a decision I was toying with, which is why some of the links open in the same page and some open in a new tab. I wanted users to try both and see which was most popular, then make the linking uniform.

So, that's +1 for "open in same window" =)

#43 Non-external links should always open in the same window/tab - I don't want to be looking for something 6- clicks deep and have 7 windows open at the end, I'd feel like I was using explorer in Windows 95 again.

#44 @BlueRaja - Ahhh Windows 95. Those were the days. OK, unless someone else puts up a good argument I will change the links sometime soon. I want the pages to get a good deal of traffic before I start making changes. It's a good thing we have the new setup that allows updates to happen so frequently =)

#45 Apart from that one pet peeve of mine (plus it's a general web development guideline), everything is an improvement :)
For future reference, do whatever you are doing, but more of it.

Mythbusters and TGB reading all night for me!

#46 @Ronny - Yeah, I'm still relatively new to web development practices. Hell, I never even touched .html or .php code before a few months ago =)

#47 Michael -Is this thread where you want us to post things a little off? The formatting in the Behavior Fish Game Tutorial needs help.

#48 @jydog - Absolutely. Any issues related to the TGB landing page or Official TGB Docs should be posted here. That way I can just go down the threads and fix each problem.

Speaking of which, how does everyone feel the changes I made based on your feedback?

#49 Jydog, what browser are you using? I noticed that with Internet explorer the formatting was off but with firefox it was fine (or the other way round)

But check your browser see if it changes anything :)

#50 Seams to be both.

#51 @jydog - Ahh, I see now. I was thinking about the regular fish game tutorial. The new behavior version is indeed borked. I got it on my list of priority fixes.

#52 I'm a bit confused - where is the link for this new fish game tutorial? There is no link on this page.

#53 Go to the official docs: TGB Docs

In the sidebar, there is a category called "Behavior Tutorials." It can be found there. I'm going to be doing a major content pass on TGB tutorials in the future, so if you all find more bugs or problems let me know ASAP.

#54 *Note* - Just found these bugs, posting here for future reference as something that needs to be fixed:

Offline Docs - Reference->addBehaviorField has incorrect information
Online Docs - Several reference docs did not make it into the release, need to correct this (high priority)

#55 Ah, I see; the span with id StepBlock-1-1 (in the Fish tutorial) should not have the style attribute position: absolute
Javascript still seems jacked though

#56 @BlueRaja - Correct! If you have access to the offline docs that shipped with TGB, you can kind of go through them side by side with the online docs. If you actually dig into the html and java code, you'll find the differences are more than just cosmetic.

#57 Documentation Update
I've updated the TGB Landing Page:

- Links to TDN and GG pages now open in same window/tab
- Links to 3rd party site open in new window/tab
- Fixed grammatical errors

*Note - You may not see the changes immediately. The server cache has to be flushed.

#58 The TGB Object/Class Reference page, does not seem to mention the behavior related classes. For example, I was trying to verify that I could do, t2dSceneObjectObj.findBehavior("behaviorName"), turns out its getBehavior, but I could not find that information there in the object/class reference. I noticed nothing behavior related seem to be there. BehaviorComponent is not mentioned as the Parent of t2dSceneObject, etc..

#59 I'd like to follow on to the comments by James.. There are a *LOT* of undocumented classes, and a lot of the ones that are "documented" have just barely any useful information.

For example, I'm trying to determine how I can use the t2dShapeVector via code... after a good search for this on the forums and TDN... nada...

This is an area that needs some serious effort, I seem to waste a good bit of time (which I don't get a lot of) when I do get a chance to actually do some TGB coding/experimenting, trying to find good information.

BTW, the look and feel for the new documentation site is looking good, it will be awesome to see the existing TDN content migrated into this new format so I don't have to go looking in 3 different spots. :D

Thanks again Michael.

#60 @James - Some kind of error occurred while generating the web docs. The online TGB docs ended up with some reference docs that the offline version does not have, and vice versa. I need to go through the generators and see what got borked. In general, the reference docs need to be unified between the offline and online docs. Thanks for that catch as well.

@Scott - In terms of sheer grunt work and time consumption, getting the reference docs (which are mostly generated by Doxygen) cleaned up and filled out is on top. While this task is a priority, it's not something I can tackle by myself and still work on other docs. I've already figured out a couple of solutions, but rest assured that I second your desire to have this area fixed up.

Good input =)

Also, I hope to see most of you in IRC Hour this Thursday if you can make it.