Yep I agree, the docs should be improved. I personally had to do a lot of head scratching to get a few bots and apps out. Looking forward to this, and the Steemit Whitepaper update. If you can spare the resources it would be awesome to get someone on docs, or even make a new hire.