@dantheman

I know, I know-- code is documentation.  And ya know what?  I totally believe that, too.  The finest computer code makes its intentions plain at a glance and has inline docs for clarity.   

Now, that said, there's a pretty big contingent of technically skilled folks who think that this blockchain is the way forward for the web-- and maybe even for society at large.  And really, it's *quite* stupendous.  But I want to tell ya something-- at the moment both myself and most of the devs I know are stumbling all over some really basic stuff in the case of steem/steemit.com, and we're stumbling all over this stuff not even because of a lack of documentation-- the best code most surely is documentation-- instead, it's because of a lack of standardization.

And this isn't really to assign blame.  This is about asking you to lead the charge, Dan.  I could-- plenty of people could, but the fact is that you're setting the pace and tone for this project.  So I'd like to ask you to change the mindset with which you're approaching it-- then again, I might be off-base and not seeing the bigger picture, but I'm talking about looking at steemit.com as an offshoot of STEEM, and then looking at STEEM as THE future of the web.  

Here are some things that I know would help with development, especially by first-timers:

* JSON Schema
* Apparently [gRPC](http://www.grpc.io/faq/) can function like [swagger](swagger.io), but for JSON-RPC apis
* 1000-blocks-of-steem.json
* 10000-blocks-of-steem.json
* 100000-blocks-of-steem.json
* 1000000-blocks-of-steem.json
* Guides for getting DBs set ups
* A guide for rendering STEEM's JSON documents using Hugo
* Hooks in the koa part of steemit.com to allow folks who have silly domain names like jacobgadikian.com forward them to steemit.com/@faddat
  * later on; the ability to apply a hugo template to all of the stories at steemit.com/@faddat

If we, as a community succeed in bringing software developers into our orbit and making them very happy here, then I've no doubt at all that we'll be looking at a >$1B STEEM blockchain by q2 2017.  

So, how can we help? :)

What do you think steem / steemit needs?

What's an area that you think devs have missed out on so far?

-TheDevs