docs: Move spec to cosmwasm documentation

Makefile

@@ -48,6 +48,11 @@ build-libwasmvm:
 	cp libwasmvm/target/release/$(SHARED_LIB_SRC) internal/api/$(SHARED_LIB_DST)
 	make update-bindings
 
+# use release build to actually ship - smaller and much faster
+.PHONY: doc-rust
+doc-rust:
+	(cd libwasmvm && cargo doc --no-deps --open)
+
 .PHONY: build-go
 build-go:
 	go build ./...

README.md

@@ -6,6 +6,9 @@ allows you to compile, initialize and execute CosmWasm smart contracts from Go
 applications, in particular from
 [x/wasm](https://github.com/CosmWasm/wasmd/tree/master/x/wasm).
 
+More information on what is CosmWasm and how to use it can be found here:
+[CosmWasm Docs](https://cosmwasm-docs.vercel.app/).
+
 ## Structure
 
 This repo contains both Rust and Go code. The Rust code is compiled into a
@@ -37,7 +40,7 @@ make release-build-windows
 
 ### Go code
 
-The Go code consistes of three packages:
+The Go code consists of three packages:
 
 1. The types (the `github.com/CosmWasm/wasmvm/types` import), using
    `package types`
@@ -148,17 +151,13 @@ which for example excludes all 32 bit systems.
 
 ## Docs
 
-Run `(cd libwasmvm && cargo doc --no-deps --open)`.
-
-## Design
-
-Please read the [Documentation](./spec/Index.md) to understand both the general
-[Architecture](./spec/Architecture.md), as well as the more detailed
-[Specification](./spec/Specification.md) of the parameters and entry points.
+The general wasmvm documentation can be found (HERE)[]. To generate and show
+the Rust part documentation you can run `make doc-rust`.
+# TODO tkulik: Place a link to the vercel docs here
 
 ## Development
 
-There are two halfs to this code - go and rust. The first step is to ensure that
+There are two halves to this code - go and rust. The first step is to ensure that
 there is a proper dll built for your platform. This should be `api/libwasmvm.X`,
 where X is: