Hey @reidbaker, while I (and many other people) agree that the documentation can be improved, I really think your tone is innapropriate (UPPERCASE IS A BIT AGRESSIVE FOR THE READER DON'T YOU THINK SO ?).
As mentioned above, Allegorithmic has a really reactive customer support and make everything possible to fix any issue/bug/questions. I don't even know if we can call this a "customer support", as you are speaking directly with the developers most of the time. I have been working in the industry for a while right now, and they are number one for me on this domain.
So once again, "yes" they can improve the documentation (even if all the SD4 documentation remains true), but I wouldn't exchange the actual awesome relationship they build with their user base, against the best documentation in the world.
I am sure we will soon have both :-)
I don't disagree with the tone being aggressive and perhaps misplaced. The UE4 stuff was pretty much the tipping point in my frustration with documentation and information being out of sync since it costs a bunch of time as a user trying to find how to be properly on boarded and not having confidence in the time being spent usefully. I don't think the product itself is the issue; sure there are bugs, but it's hard to tell what's going on when things are out of sync with the information available and there's very little branded with the latest versions. It's inaccurate to suggest tutorials and existing documentation haven't changed for the existing toolsets, because it's not 100% - and it's the few things that are inconsistent that can devour time trying to resolve.
Fact remains, they should have already had the information more organized before releasing. I love what Allegorithmic is doing, but with trying to introduce such a beastly and powerful new workflow, on boarding is one of the single most critical components to releasing the software. More hand-holding is better than less in this case - and that applies to new releases.