From 250503b2d39b9b2adf75dd9f2c009421e8a9fe8e Mon Sep 17 00:00:00 2001
From: Peter deHaan <peter@deseloper.com>
Date: Mon, 26 Jun 2017 12:34:31 -0700
Subject: [PATCH] Update README with some more details

---
 README.md      | 49 ++++++++++++++++++++++++++++++++++++++++++++++---
 docs/docker.md | 18 +++++++++++-------
 2 files changed, 57 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index bf892c31..ac497228 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,46 @@
-* Install the redis server if not installed.
-* To run the project, make sure you have a redis server running locally: redis-server /usr/local/etc/redis.conf
-* Follow instructions inside the console on the browser.
+# Firefox Fileshare
+
+[![CircleCI](https://circleci.com/gh/mozilla/something-awesome.svg?style=svg)](https://circleci.com/gh/mozilla/something-awesome)
+
+## What it does
+
+A P2P file sharing experiment which allows you to send encrypted files to other users.
+
+## Requirements
+
+- [Node.js 8+](https://nodejs.org/)
+- [Redis server](https://redis.io/)
+
+**NOTE:** To run the project, make sure you have a Redis server running locally: 
+
+```sh
+$ redis-server /usr/local/etc/redis.conf
+```
+
+## How to use it
+
+| Command          | Description |
+|------------------|-------------|
+| `npm run dev`    | Builds and starts the web server locally for development.
+| `npm run format` | Formats the frontend and server code using **prettier**.
+| `npm run lint`   | Lints the CSS and JavaScript code.
+| `npm start`      | Starts the Express web server.
+| `npm test`       | Runs the suite of mocha tests.
+
+## Localization
+
+_Coming soon_ (see [#57](https://github.com/mozilla/something-awesome/issues/57))
+
+## Contributing
+
+Pull requests are always welcome! Feel free to check out the list of ["good first bugs"](https://github.com/mozilla/something-awesome/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22).
+
+## Testing:
+
+- Production: _Coming soon_ (see [#20](https://github.com/mozilla/something-awesome/issues/20))
+- Stage: https://fileshare.stage.mozaws.net/
+- Development: https://p2p.dev.lcip.org/
+
+## License
+
+[Mozilla Public License Version 2.0](LICENSE)
diff --git a/docs/docker.md b/docs/docker.md
index d0702397..cc9d4bd7 100644
--- a/docs/docker.md
+++ b/docs/docker.md
@@ -1,10 +1,14 @@
-Environment Variables:
+## Environment variables:
 
-PORT - port the server will listen on (defaults to 1443)
-P2P_S3_BUCKET - the S3 bucket name
-P2P_REDIS_HOST - host name of the redis server
-NODE_ENV - production
+| Name             | Description
+|------------------|-------------|
+| `PORT`           | Port the server will listen on (defaults to 1443).
+| `P2P_S3_BUCKET`  | The S3 bucket name.
+| `P2P_REDIS_HOST` | Host name of the Redis server.
+| `NODE_ENV`       | "production"
 
-Example
+## Example:
 
-docker run --net=host -e 'NODE_ENV=production' -e 'P2P_S3_BUCKET=testpilot-p2p-dev' -e 'P2P_REDIS_HOST=dyf9s2r4vo3.bolxr4.0001.usw2.cache.amazonaws.com' mozilla/portal:latest
+```sh
+$ docker run --net=host -e 'NODE_ENV=production' -e 'P2P_S3_BUCKET=testpilot-p2p-dev' -e 'P2P_REDIS_HOST=dyf9s2r4vo3.bolxr4.0001.usw2.cache.amazonaws.com' mozilla/portal:latest
+```