feat: adds docs building and config

Signed-off-by: Carson Farmer <carson.farmer@gmail.com>

.github/workflows/docs.yml

@@ -0,0 +1,43 @@
+name: Docs
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    name: Docs
+    runs-on: ubuntu-latest
+    if: "!contains(github.event.head_commit.message, 'skip-ci')"
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v1
+
+      - name: Cache
+        uses: actions/cache@v1
+        with:
+          path: ~/.npm # npm cache files are stored in `~/.npm` on Linux/macOS
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-build-${{ env.cache-name }}-
+            ${{ runner.os }}-build-
+            ${{ runner.os }}-
+      - name: Setup
+        uses: actions/setup-node@v1
+        with:
+          node-version: 12
+          registry-url: https://registry.npmjs.org/
+
+      - name: Install
+        run: npm install
+
+      - name: Docs
+        run: npm run docs
+
+      - name: Deploy
+        uses: peaceiris/actions-gh-pages@v3
+        env:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          PUBLISH_BRANCH: gh-pages
+          PUBLISH_DIR: docs

.github/workflows/review.yml

@@ -2,10 +2,10 @@ name: Review
 on:
   push:
     branches:
-      - master
+      - main
   pull_request:
     branches:
-      - master
+      - main
 
 jobs:
   lint:

.gitignore

@@ -125,4 +125,5 @@ dist
 .vscode-test
 
 # End of https://www.toptal.com/developers/gitignore/api/code,node
-n
+
+docs/

README.md

@@ -1,16 +1,35 @@
 Javascript implementation of Textile's ThreadDB
 
+[![Textile](https://img.shields.io/badge/made%20by-Textile-informational.svg)](https://textile.io)
+[![Slack](https://img.shields.io/badge/slack-slack.textile.io-informational.svg)](https://slack.textile.io)
+[![License](https://img.shields.io/github/license/textileio/js-threaddb.svg)](./LICENSE)
+[![Release](https://img.shields.io/github/release/textileio/js-threaddb.svg)](https://github.com/textileio/js-threaddb/releases/latest)
+
+![Test](https://github.com/textileio/js-threaddb/workflows/Test/badge.svg)
+![Review](https://github.com/textileio/js-threaddb/workflows/Review/badge.svg)
+[![Docs](https://github.com/textileio/js-threaddb/workflows/Docs/badge.svg)](https://textileio.github.io/js-threaddb)
+
 > An offline-first local db that syncs to the distributed web.
 
+## Getting help
+
+The Textile/Threads developers/community are active on [Slack](https://slack.textile.io/) and
+[Twitter (@textileio)](https://twitter.com/textileio), join us there for news, discussions,
+questions, and status updates. Also, [check out our blog](https://blog.textile.io) for the
+latest posts and announcements.
+
+If you think you've found a bug in threaddb, please file a github issue. Take a look at our
+comprehensive [contributor guide](#contributing) for details on how to get started.
+
 ## Getting Started
 
 ### Development
 
 Start by cloning and digging into this repo:
 
 ```bash
-git clone git@github.com:textileio/thread-db.git
-cd thread-db
+git clone git@github.com:textileio/js-threaddb.git
+cd threaddb
 ```
 
 Next, install the required `npm` modules:
@@ -119,3 +138,20 @@ If you are working in vscode or vscodium, the following local settings are usefu
 These settings pair nicely with the `hbenl.vscode-mocha-test-adapter` and
 `ryanluker.vscode-coverage-gutters` plugins. I also highly recommend `dbaeumer.vscode-eslint` for
 in-editor linting. Note that we also use prettier for code formatting (called via eslint).
+
+## API
+
+See [https://textileio.github.io/js-threaddb](https://textileio.github.io/threaddb), which includes
+the technical API docs for all subpackages.
+
+## Maintainers
+
+[Carson Farmer](https://github.com/carsonfarmer)
+
+## Contributing
+
+PRs gratefully accepted! Please see above for details on getting started.
+
+## License
+
+[MIT](./LICENSE) (c) 2019-2020 Textile