> The only real problem is that Joyent either doesn't document anything, or it's hard to find, and they don't maintain half the software they advertise (but also won't confirm or deny that it's not maintained or mark it as unmaintained, so good luck finding out what you should be using instead).

Have you sent that feedback, possibly pinged bcantrill on the issue (being Joyent's CTO I'd expect devdocs would fall under his purview)?