organize godoc and point to C documentation

- move top-level godoc to a new file, mdb.go
- add an introduction that points to the C docs
add a short (godoc embedded) example based on tests