wip improve docs

Author: heapwolf

.gitignore

@@ -1,3 +1,4 @@
 /deps
 /bin/*
-/lib/*
+/lib/hypercore.so
+/lib/hypercore.a

README.md

@@ -1,6 +1,28 @@
 # SYNOPSIS
 Hypercore is a secure, distributed append-only log.
 
+# OBJECTIVES
+- `datcxx` should ultimately output Static and Dynamic shared Libraries (so the
+internal structure of this project won't matter to the end consumer).
+
+- You should be able to do something like `[brew|apt] install libdat` and then
+`#include <libdat>` and use it like it was any other C++ library.
+
+- It will have a public interface that is at parity with other implementations
+(the JavaScript implementation being today's canonical implementation).
+
+# FAQ
+
+```
+Q: Will I need to use `build` if I want to use `datcxx`?
+A: No.
+```
+
+```
+Q: I tried brew or apt install but I cant install this.
+A: It's not ready yet.
+```
+
 # BUILD
 To generate a `shared library`, install the [`build`][0] tool and run the
 following command...
@@ -9,7 +31,18 @@ Run install and then build.
 
 ```bash
 build i
-build -g
+build test
+build run shared
 ```
 
+If you want to produce a static library run
+
+```
+build run static
+```
+
+# SEE ALSO
+How [dat][1] works.
+
 [0]:https://github.com/datcxx/build
+[1]:https://datprotocol.github.io/how-dat-works/

lib/hypercore.so

@@ -6,10 +6,15 @@
     "url": "[email protected]:datcxx/cxx-hypercore.git"
   },
   "dependencies": {
-    "[email protected]:datcxx/cxx-flat-tree": "c051eac4"
+    "[email protected]:datcxx/cxx-flat-tree": "c051eac4",
+    "[email protected]:datcxx/cxx-eventemitter": "63d10af1",
+    "[email protected]:datcxx/cxx-timers": "7d2ff2b7",
+    "[email protected]:heapwolf/cxx-tap": "07821de0"
   },
   "scripts": {
-    "test": "c++ -std=c++2a test/index.cxx lib/hypercore.so -o test/index && ./test/index"
+    "test": "c++ -std=c++2a test/index.cxx lib/hypercore.so -o test/index && ./test/index",
+    "shared": "",
+    "static": ""
   },
   "flags": [
     "-shared",

lib/hypercore.so.dSYM/Contents/Info.plist

@@ -1,7 +1,14 @@
 #include "../index.hxx"
+#include "../deps/heapwolf/cxx-tap/index.hxx"
 
 #include <iostream>
+#include <sstream>
 
-int main () {
-  std::cout << Hypercore::getIndex() << std::endl;
+int main() {
+  TAP::Test t;
+
+  t.test("sanity", [](auto t) {
+    t->ok(true, "true is true");
+    t->end();
+  });
 }