Defending the use of trace(), dump(), echo(), and searching this forum as a proper substitute for documentation, rather than a "whatever, good enough, I can live with it" kind of compromise, only proves to me that (in a programming context) you don't actually know first-hand what "documentation" is.
Are you trying to make some kind of poorly thought out jab at my programming ability? If you read my post again, you can see that the entire point of my post is that the existing features are enough to live with, not that they're a proper substitute for documentation. I even specifically said that documentation would make it easier.
Documentation is invaluable for libraries and APIs. Without OpenGL documentation, I wouldn't be able to work on any games at all. It's incredibly useful. I'm not even trying to discredit its value. The thing is, it's not Badspot's fault that documentation doesn't exist for TorqueScript. What you're demanding is like yelling at a developer who implemented DevIL for not providing a full reference on how to interface with DevIL. Badspot simply used the game engine, he's under no obligation to explain how to use it to us. The fact that the people responsible for documentation, Garage Games, failed to do so adequately before their discontinuation of Torque isn't Badspot's fault, and he's not responsible for it.
Thankfully, GarageGames did provide you with a tool that acts like mutable documentation that automatically updates. They covered their bases with their own functions by requiring a definition to define a console method, and provided you with a tool to figure out how other functions are called.
The only thing Badspot
might be under obligation to document is his own virtual (via TorqueScript/DSO) additions to the game. He's expressed numerous times that he has no intention of doing so, though, so it's not even worth bringing up. Even if you were to convince half the forum that documentation should be made, he'd do nothing about it. There's precedence of this with the Ephialtes drama that happened not too long ago. Damn near half the forum, if not more, wanted his admin revoked. Guess what Badspot did? Essentially told them to go forget themselves.
Maybe, maybe I'll document his virtual functions for him. I can already tell it'd be a huge pain in the ass though, so I completely understand why he doesn't want to.