I have to agree that the documentation is lacking. I’ve been working with websites for many years, but I rarely have to deal with wp themes. I don’t want to mention your competitor here, but if you send me a private message, I will gladly point you to a competitor who has documentation that many people seem to appreciate. I can’t find the documentation online, but he does vimeo videos for every aspect of the theme.
You have to approach instruction as if the person you’re instructing has no knowledge about the way wordpress works. Don’t ever leave steps out. Just because you know the steps doesn’t mean your user does.