Refactor Docs

[ebuchman]

This is the start of a reorg to the docs. Some notable points

• Gut the README so its more accessible
• Start building cohesive documentation under /docs/sdk
• See the /docs/sdk/README.md for structural overview
• Deprecate /docs/guide/sdk (everything has been moved to /docs/sdk)

[codecov]

Codecov Report

Merging #1289 into develop will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff            @@
##           develop    #1289   +/-   ##
========================================
  Coverage    65.61%   65.61%           
========================================
  Files          103      103           
  Lines         5572     5572           
========================================
  Hits          3656     3656           
  Misses        1713     1713           
  Partials       203      203

[ebuchman]

Ok so, there's really a lot to do here to make these docs properly, and I think some of that has to do with reorganizing the code along the lines of #976 . We should also try to make as much use of the GoDoc as possible so we're not always copying definitions everywhere, but we probably need to improve the package structure to do that. So I'm going to stop here and we should have a meeting to discuss how best to lay out the documentation and a strategy for getting it written ...

[ebuchman]

Discussed this with @AdityaSripal @jlandrews and @jolesbi and made some minor changes based on that. The basic idea for explaining the core is as follows:

• Goal is to build up to Basecoin through a series of apps. Each app builds on the last one until we get to Basecoin
• App1: just messages, handlers, baseapp, store (no accounts, tx, amino, keeper, etc.)
• App2: Introduce Amino
• App3: Accounts and Transactions
• App4: Keepers

By now we have a full basecoin, but there's still more to explain. For the advanced section, we can maybe use demo coin, or just point to gaia.

[jbibla]

what's the status on this PR?

[ebuchman]

Just rebased on develop. Let's merge when tests pass and pick up from there