Game Development Community

Confusing instructions

by Gregory "Centove" McLean · in Torque Game Engine · 04/17/2004 (9:19 am) · 4 replies

If this isn't the right place for this, point me at the correct place :)

Just bought the SDK (whee) That sent me to this url:
http://www.garagegames.com/mg/projects/torque1/downloads.php

which has the following text:
---
This link brings you to our CVS Client configuration documentation. Follow these easy steps and you will be downloading the Torque Source code in just a few minutes.
---
Umm.. what link? I don't see no link.

Ok so maybe its that link above "Torque Game Engine SDK (CVS Instructions - RECOMMENDED)"

That goes here:
http://www.garagegames.com/docs/torque.sdk/gstarted/cvs.html

Starts off by describing cvs how to install a client (blah blah blah yes I know what CVS is and I already have it installed.)

Scroll down to the section:
Versions & Version Tags

It has this sentence:
Please refer to the Step Three: Checkout section above for instructions on how tags are used.
(Step Three: Checkout is the link)
That leads to:
http://www.garagegames.com/docs/torque.sdk/gstarted/cvs.html#Checkout
(ie no where, same page, no anchor named #Checkout)

I'm _guessing_ its supposed to go to the checkout section on:
http://www.garagegames.com/docs/torque.sdk/gstarted/cvs..html

However the email that was sent out pointed me here:
http://www.garagegames.com/docs/torque/cvs/

Which made more sense and I was able to get the source. (basically all I needed was the CVSROOT)

Maybe stick a FAQ (Yeah I looked there before checking my email):
Whats the CVSROOT so I can get the source?

Thanks!

#1
04/17/2004 (9:26 am)
Lol. The docs have very recently been revamped so theres some bugs here and there. Thanks for pointing them out. I'm sure Josh will fix them up.
#2
04/17/2004 (9:33 am)
Heh... I thought I was loosing my mind. I was looking at the source of the pages in question looking for broken browser sniffers to see what I needed to make mozilla represent itself to be. :)
#3
04/17/2004 (9:40 am)
The CVS root by the way if you were needing it is :pserver:username@cvs.garagegames.com:/cvs/torque
#4
04/17/2004 (6:27 pm)
Thanks Gregory.

Quote:
However the email that was sent out pointed me here:
http://www.garagegames.com/docs/torque/cvs/

Which made more sense and I was able to get the source.

Whew. That is the new CVS documentation stuff. The stuff you were talking about at the beginning of the thread was the old documentation. Glad that the new stuff at least is an improvement. :)

That said, the new CVS stuff could definitely be better too. We are planning on re-vamping it, but it's about #9 on my list of changes, so it might take a while.

What we should change ASAP is the fact that you were linked to the old docs at all in the first place. I will ask Rick or Alex or someone with authority to change the site to fix the link there.