baseapp

docs/sdk/README.md

@@ -4,12 +4,13 @@ NOTE: This documentation is a work-in-progress!
 
 - [Overview](overview) 
     - [Overview](overview/overview.md) - An overview of the Cosmos-SDK
-    - [The Object-Capability Model](overview/capabilities.md) - 
-    - [Application Architecture](overview/apps.md) - Understanding SDK
-      application architecture
-- [Install](install.md) - Install the SDK library and example applications
+    - [The Object-Capability Model](overview/capabilities.md) - Security by
+      least-privilege
+    - [Application Architecture](overview/apps.md) - Layers in the application architecture
+- [Install](install.md) - Install the library and example applications
 - [Core](core)
-    - [The Store](core/store.md) - How to work with the database 
+    - [BaseApp](core/baseapp.md) - BaseApp is the base layer of the appication
+    - [The MultiStore](core/multistore.md) - MultiStore is a rich Merkle database
     - [Messages](core/messages.md) - Messages contain the content of a transaction
     - [Handlers](core/handlers.md) - Handlers are the workhorse of the app!
     - [Amino](core/amino.md) - Amino is the primary serialization library used in the SDK

docs/sdk/core/baseapp.md

@@ -0,0 +1,19 @@
+# BaseApp
+
+The BaseApp is an abstraction over the [Tendermint
+ABCI](https://github.com/tendermint/abci) that
+simplifies application development by handling common low-level concerns.
+It serves as the mediator between the two key components of an SDK app: the store
+and the message handlers.
+
+The BaseApp implements the
+[`abci.Application`](https://godoc.org/github.com/tendermint/abci/types#Application) interface. 
+It uses a `MultiStore` to manage the state, a `Router` for transaction handling, and 
+`Set` methods to specify functions to run at the beginning and end of every
+block. 
+
+Every SDK app begins with a BaseApp:
+
+```
+app := baseapp.NewBaseApp(appName, cdc, logger, db),
+```