Documentation Structure Change and Cleanup (#2808)

* Update docs/sdk/clients.md
* organize ADR directory like tendermint
* docs: move spec-proposals into spec/
* remove lotion, moved to website repo
* move getting-started to cosmos-hub, and voyager to website
* docs: move lite/ into clients/lite/
* move introduction/ content to website repo
* move resources/ content to website repo
* mv sdk/clients.md to clients/clients.md
* mv validators to cosmos-hub/validators
* move deprecated sdk/ content to _attic
* sdk/modules.md is duplicate with modules/README.md
* consolidate remianing sdk/ files into a single sdk.md
* move examples/ to docs/examples/
* mv docs/cosmos-hub to docs/gaia
* Add keys/accounts section to localnet docs

docs/examples/kvstore/main.go

@@ -0,0 +1,91 @@
+package main
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+
+	"github.com/spf13/viper"
+
+	"github.com/tendermint/tendermint/abci/server"
+	"github.com/tendermint/tendermint/libs/cli"
+	cmn "github.com/tendermint/tendermint/libs/common"
+	dbm "github.com/tendermint/tendermint/libs/db"
+	"github.com/tendermint/tendermint/libs/log"
+
+	bam "github.com/cosmos/cosmos-sdk/baseapp"
+	sdk "github.com/cosmos/cosmos-sdk/types"
+)
+
+func main() {
+
+	logger := log.NewTMLogger(log.NewSyncWriter(os.Stdout)).With("module", "main")
+
+	rootDir := viper.GetString(cli.HomeFlag)
+	db, err := dbm.NewGoLevelDB("basecoind", filepath.Join(rootDir, "data"))
+	if err != nil {
+		fmt.Println(err)
+		os.Exit(1)
+	}
+
+	// Capabilities key to access the main KVStore.
+	var capKeyMainStore = sdk.NewKVStoreKey("main")
+
+	// Create BaseApp.
+	var baseApp = bam.NewBaseApp("kvstore", logger, db, decodeTx)
+
+	// Set mounts for BaseApp's MultiStore.
+	baseApp.MountStoresIAVL(capKeyMainStore)
+
+	// Set a handler Route.
+	baseApp.Router().AddRoute("kvstore", Handler(capKeyMainStore))
+
+	// Load latest version.
+	if err := baseApp.LoadLatestVersion(capKeyMainStore); err != nil {
+		fmt.Println(err)
+		os.Exit(1)
+	}
+
+	// Start the ABCI server
+	srv, err := server.NewServer("0.0.0.0:26658", "socket", baseApp)
+	if err != nil {
+		fmt.Println(err)
+		os.Exit(1)
+	}
+	err = srv.Start()
+	if err != nil {
+		cmn.Exit(err.Error())
+	}
+
+	// Wait forever
+	cmn.TrapSignal(func() {
+		// Cleanup
+		err = srv.Stop()
+		if err != nil {
+			cmn.Exit(err.Error())
+		}
+	})
+	return
+}
+
+// KVStore Handler
+func Handler(storeKey sdk.StoreKey) sdk.Handler {
+	return func(ctx sdk.Context, msg sdk.Msg) sdk.Result {
+		dTx, ok := msg.(kvstoreTx)
+		if !ok {
+			panic("Handler should only receive kvstoreTx")
+		}
+
+		// tx is already unmarshalled
+		key := dTx.key
+		value := dTx.value
+
+		store := ctx.KVStore(storeKey)
+		store.Set(key, value)
+
+		return sdk.Result{
+			Code: 0,
+			Log:  fmt.Sprintf("set %s=%s", key, value),
+		}
+	}
+}

docs/examples/kvstore/tx.go

@@ -0,0 +1,67 @@
+package main
+
+import (
+	"bytes"
+
+	sdk "github.com/cosmos/cosmos-sdk/types"
+	"github.com/cosmos/cosmos-sdk/x/auth"
+)
+
+// An sdk.Tx which is its own sdk.Msg.
+type kvstoreTx struct {
+	key   []byte
+	value []byte
+	bytes []byte
+}
+
+func (tx kvstoreTx) Route() string {
+	return "kvstore"
+}
+
+func (tx kvstoreTx) Type() string {
+	return "kvstore"
+}
+
+func (tx kvstoreTx) GetMsgs() []sdk.Msg {
+	return []sdk.Msg{tx}
+}
+
+func (tx kvstoreTx) GetMemo() string {
+	return ""
+}
+
+func (tx kvstoreTx) GetSignBytes() []byte {
+	return sdk.MustSortJSON(tx.bytes)
+}
+
+// Should the app be calling this? Or only handlers?
+func (tx kvstoreTx) ValidateBasic() sdk.Error {
+	return nil
+}
+
+func (tx kvstoreTx) GetSigners() []sdk.AccAddress {
+	return nil
+}
+
+func (tx kvstoreTx) GetSignatures() []auth.StdSignature {
+	return nil
+}
+
+// takes raw transaction bytes and decodes them into an sdk.Tx. An sdk.Tx has
+// all the signatures and can be used to authenticate.
+func decodeTx(txBytes []byte) (sdk.Tx, sdk.Error) {
+	var tx sdk.Tx
+
+	split := bytes.Split(txBytes, []byte("="))
+	if len(split) == 1 {
+		k := split[0]
+		tx = kvstoreTx{k, k, txBytes}
+	} else if len(split) == 2 {
+		k, v := split[0], split[1]
+		tx = kvstoreTx{k, v, txBytes}
+	} else {
+		return nil, sdk.ErrTxDecode("too many =")
+	}
+
+	return tx, nil
+}