Does T3D have a wiki?

#1 No, it does not.

#2 Torque 3D will not be a wiki, or share any information on TDN.

100% of Torque 3D documentation will be the official content provided by GarageGames. This will ship with the engine, with frequent updates available online for viewing or downloading.

#3

Quote:100% of Torque 3D documentation will be the official content provided by GarageGames. This will ship with the engine, with frequent updates available online for viewing or downloading.

woot woot!

#4 A section on something such as TDN would be a good idea though.

I mean, no offense but its much more organized than the actual website (Working search in near future? :P). And would be a great resource, if people used it.

#5 I'd be very happy with a chm version of the documentation :-)
Generally much more convenient than a web version (just look at MSDN).

#6 I hope there will be some sort of community site where information can be shared. Although documentation will be good I am sure, it is still just that - documentation. Having additional information from the community on different ways to do things is a plus and is very difficult to find in the forums.

I realize the TDN was not that up to date, but with the recent website changes and lack of any user supported WIKI, just doesn't seem like the same GG that I have been following for so long.

#7 @Randy

TDN could be up-to-date, but its a Wiki, and requires the community add resources. GG is supposed to be about the "community"(take that in any way you want) so it would make sense that a Wiki would work, or would seem to make sense. If the community just put effort in to the TDN as a whole it would be the best resource on the site.

I guess I just kinda resaid what I said 2 posts up so /facepalm for me

#8 If needed I can host a wiki on a fast server, but someone else will have to keep the keys ;-)

#9 THIS STATEMENT:

Quote:TDN could be up-to-date, but its a Wiki, and requires the community add resources.

CONTRASTS WITH THIS STATEMENT:

Quote:GG is supposed to be about the "community"(take that in any way you want) so it would make sense that a Wiki would work, or would seem to make sense.

But the next statement rectifies it:

Quote:If the community just put effort in to the TDN as a whole it would be the best resource on the site.

TDN was the community's responsibility, and it became an absolute mess. To the extent that it was used as a criticism AGAINST documentation.

Torque 3D's documentation has been my world for the past 5 months. The fate of TDN is still up in the air, and I'm not going to bank on Torque 3D having a section there.

The forums: Great for Torque 3D Discussion

The Resources: Great for Torque 3D add-ons, code, and user submitted documentation.

The Official Documentation: Great for Torque 3D reference.

If someone wants a tutorial or reference article in the official docs, all he/she has to do is e-mail me. What I can organize and write is far beyond what TDN is able.


We have been discussing TDN for a while now, and right now it is on hold until a final decision is made. So, just to reiterate...the official documentation will be THE source for Torque 3D information for a while.

#10 I've found wikis can get into an organization mess very quickly on several projects without a person to maintain and organize the wiki.

With strictly broken down categories and templates it can work very well.

#11 The ironic part is that I'm writing all of the Torque 3D documentation in a wiki running on my local machine. However, there is no reason to put a version online for people to edit. Any problems found can be remarked upon in the official feedback thread.

#12 Yea... as much as i hate to admit it... TDN has been an total failure.

The community never really took hold there... i suppose the GG forums and resources were just too good at doing some of the same things.

#13 All this talk of TDN and no link:
tdn.garagegames.com/wiki/TDN_Home

#14 Is there any way we could try a TDN page though? I mean, that's one of the things we can't do on our own. (Don't want to give away source etc.)

Or, improvements to the GG search would really make things easy. I dunno, to me it's still a junker and I can never find what I want. But it's better than it used to be.

EDIT: Also, a good look at the resources section of the site and I always think to myself how much quicker I would get my searches done if the resource specifically stated which engine/version it was for. E.G:

Code: durrrr (TGEA / 1.8.1)

xyz xyz xyz xyz

Comment 4 comments Author Steve Stevenson Date 04/21/2009 (1:16 am)

#15 If we keep TDN, it should be revamped. It can serve the same purpose, but the content needs to be adjusted. TDN allowed the community to scratch an itch. It is the longest running GarageGames community project, even if it isn't a game project.

As a means of documentation, I think it started very strong but eventually bombed. If it were to be revitalized, I think it should be taken in a different direction.

#16

Quote:Or, improvements to the GG search would really make things easy. I dunno, to me it's still a junker and I can never find what I want. But it's better than it used to be.

Boolean search would be good. Most forum searches have an option to search for "any of the words" or "all of the words".

Google and old library systems let you look for this AND that AND "brain twitter".

#17 The TDN had a lot of potential, but it actually died down.
Look at the TGB components if you own TGB to get an idea. I added a few in the 1.5 days in the hope to build up an RTS / Action Adventure like component base for all to use. What it become is just what I added, a few base components.
Many other things went a similar way.

The only time I really used TDN was TGEA pre 1.7, when the documentation just was not present and people were forced to collect information basing on Milestone docs on the TDN, the TGE documentations and hours of source reading (not source documentation as only TGE code was commented)

The TDN would make sense to be refreshed (out of my view) if it was nicely integrated with the resource system so basically both running on the same core and just showing a different part of it.

Couldn't be more happy that the documentations followed TGBs example actually :)
I assume there will also be a page in the html documentation that shows the whole docs for printing for example?

#18 What I would really like to see happen to TDN...

http://developer.valvesoftware.com/wiki/Main_Page

'Nuff said. I love that wiki.

#19 Would it be possible to organize the resources section a little more so people don't have to slog through all resources to find the types they want?

(Yes I know about search engines but categories work much better...)

#20 The first documentation set is live. Check the Torque 3D Documentation feedback thread for details.