Previous Blog Next Blog
Prev/Next Blog
by date

What do you think about Documentation?

What do you think about Documentation?
Name:Michael Perry
Date Posted:May 15, 2008
Rating:5.0 out of 5
Public:YES
Comments:YES
RSS Feed:GarageGames Blog feedor Subscribe with .
Profile Page:View profile page for Michael Perry

Blog post
***Greetings all!***

Let me get it out of the way right now:

This is a NO frills .plan. I wish I had some pretty pictures or wicked exciting news, but this blog exists purely for informative reasons. I'm tired, I just got back from an hour long dentist appointment, and I can't have my morning coffee because it keeps spilling out of my completely numb mouth. So, please forgive me if I can't scour the internet for LOLCat pics to post here =)

DOCUMENTATION
A dreaded word....Everyone WANTS it, a lot of people hate writing it, and the writing process will NEVER be finished since new versions of the engines are being released all the time. Thankfully, there is a group of people who still want to do the work, and even one insane person who actually LOVES writing documentation...ahem...

TGEA Started It All
During the TGEA 1.7 beta, I created a thread in the private forums: TGE 1.7 Documentation Feedback. The purpose of the thread was to provide a central location for TGEA users to post their feedback, criticisms, and suggestions for the new docs. The response was overwhelmingly positive, constructive, and key to getting new docs and fixes to the user for the release.

So, it's time to show the same attention to the users of the other awesome Torque engines. Stephen Zepp has created a thread in the TGB area, and every other engine has its own as well. Going a step further, the new threads are posted in the PUBLIC area, just to show some love to the people who have yet to purchase a SDK. Every opinion counts, and your feedback will help out in more ways than one. =)

TGEA Documentation Feedback
TGE Documentation Feedback
TGB Documentation Feedback
TorqueX (TX) Documentation Feedback
TorqueX Builder (TXB) Documentation Feedback

In each thread, there is an explanation, purpose, and suggestions on what we are looking for. Each thread will be monitored carefully, so let's get this rock rollin'


Edits: OK, I had to sneak in images. The plan was just too boring =)

Recent Blog Posts
List:08/14/08 - New Documentation System
07/11/08 - MAJOR Documentation Announcement 1
05/15/08 - What do you think about Documentation?
03/21/08 - What is Ars Moriendi? (images)
03/14/08 - Big News, and New Documentation
01/24/08 - New Resources and AFX Creator Demo
07/18/07 - Torque School Instructor
06/20/07 - afxWeapon Design Blog #2: Fire Sword

Submit ResourceSubmit your own resources!

Deborah Marshall   (May 15, 2008 at 16:27 GMT)   Resource Rating: 5
Great open discussion, Michael. I hope you get a ton of good responses. Bury him, guys! ^_^

Chris Calef   (May 15, 2008 at 18:27 GMT)
Buried for mentioning documentation.

Sorry, couldn't resist. =-)

Vishal Bhanderi   (Jul 22, 2008 at 21:35 GMT)   Resource Rating: 5
Can i ask if you guys are using .Net XML tags in the code. If you guys are then please tell the programmers to put some ///examples in. I would be a happy man :D

You must be a member and be logged in to either append comments or rate this resource.