This has been my experience as well; I really love SmartOS and Triton, but until Joyent cleans up the documentation or builds a big enough community to crowd source it I can't generally recommend it to new users, which is sad.