Update README.md (#107)

Added background, info links, general copy editing

Author: jessicaschilling

README.md

@@ -2,7 +2,7 @@
   <img src="https://github.com/ipfs-shipyard/npm-on-ipfs/raw/master/img/npm-on-ipfs.jpg" alt="npm distributed on top of lots of connected IPFS nodes worldwide" />
 </p>
 
-# npm on IPFS
+# npm-on-IPFS
 
 [![](https://img.shields.io/badge/made%20by-Protocol%20Labs-blue.svg?style=flat-square)](https://protocol.ai)
 [![](https://img.shields.io/badge/project-IPFS-blue.svg?style=flat-square)](http://ipfs.io/)
@@ -11,39 +11,38 @@
 [![Code Coverage](https://codecov.io/gh/ipfs-shipyard/npm-on-ipfs/branch/master/graph/badge.svg)](https://codecov.io/gh/ipfs-shipyard/npm-on-ipfs)
 [![Dependency Status](https://david-dm.org/ipfs-shipyard/npm-on-ipfs.svg?style=flat-square)](https://david-dm.org/ipfs-shipyard/npm-on-ipfs)
 
-> Install your favourite modules from the Distributed Web using IPFS. Have a cache always ready and share them in all your local networks.
+**TLDR: npm-on-ipfs enables you to install your favourite modules from the distributed web using IPFS, as well as to have a cache always ready and shared on your local network — great for enterprise and community coding settings, or even just enabling more speedy work when you and your friends are working at a low-bandwidth coffee shop.**
 
-## js-IPFS version
+## Quick background
 
-This module depends on features in [v0.34.0](https://github.com/ipfs/js-ipfs/releases/tag/v0.34.0) release of [js-ipfs](https://github.com/ipfs/js-ipfs).
+As the largest software registry in the world, [npm](https://www.npmjs.com) is also the de facto package manager for the JavaScript ecosystem, with more than [900k](https://replicate.npmjs.com/_all_docs) packages and more than 7 billion downloads a week. It's incredibly fast and reliable — however, we couldn't stop ourselves from wondering what would happen if we put the world's largest registry on the distributed web.
 
-Please ensure you are running at least that version of js-IPFS:
+The result is npm-on-ipfs: a module that wraps your package manager of choice (npm or yarn) in configuration to use [IPFS](https://ipfs.io/), not HTTP, to retrieve your dependencies from the central npm registry. It's still a work in progress, but we think you'll find it useful and awesome for the following reasons:
 
-```console
-npm install -g ipfs@latest
-```
+ - Having dependencies on the distributed web makes development **more available** because multiple nodes supplying tarballs means no panic if a single source goes dark
+ - It can also be **faster and cheaper** — if dependencies are already being hosted on your local network, this means lower bandwidth cost and higher speed 
+ - If enough dependencies are hosted on your local network (think enterprise or community development settings), that network can operate **offline-first**: Take your team on a remote mountain retreat and hack away!
 
-## Resources
+## Install & use
+### Check your js-ipfs version
 
-- [The original demo video](https://vimeo.com/147968322)
-- [Lengthy introduction in a blog post](http://daviddias.me/blog/stellar-module-management/)
-- [Node.js Interactive Talk - Stellar Module Management](https://www.youtube.com/watch?v=-S-Tc7Gl8FM)
+This module depends on features in [v0.34.0](https://github.com/ipfs/js-ipfs/releases/tag/v0.34.0) release of [js-ipfs](https://github.com/ipfs/js-ipfs), so please ensure you are running at least that version:
 
-## Lead Maintainer
-
-[Alex Potsides](https://github.com/achingbrain)
+```console
+$ npm install -g ipfs@latest
+```
 
-## Install this module
+### Install npm-on-ipfs
 
 ```console
-> npm i ipfs-npm -g
+$ npm i ipfs-npm -g
 ```
 
-# Usage
+### Get started!
 
-`ipfs-npm` wraps your chosen package manager (e.g. npm or yarn) with configuration to use IPFS to retrieve your dependences instead of over HTTP from the central npm registry.
+`ipfs-npm` wraps your favorite package manager (npm or yarn) with configuration that uses IPFS, rather than HTTP, to retrieve your dependencies from the central npm registry. Since it's intended to replace npm/yarn, all the commands you're used to will work in the same way.
 
-In the directory with your `package.json` file, run:
+For example: In the directory with your `package.json` file, run ...
 
 ```console
 $ ipfs-npm install
@@ -65,12 +64,11 @@ You can use any command you'd use with npm/yarn with ipfs-npm in exactly the sam
 $ ipfs-npm install
 $ ipfs-npm version minor
 $ ipfs-npm publish
-
 $ ipfs-npm --package-manager=yarn
 // etc
 ```
 
-## CLI
+## CLI guide
 
 ```console
 $ ipfs-npm --help
@@ -120,9 +118,9 @@ Options:
                                          [default: "https://registry.npmjs.com"]
 ```
 
-## Configuration File
+## Configuration files
 
-We use [`rc`](https://github.com/dominictarr/rc) to parse configuration files. Please see the [`rc` repository](https://github.com/dominictarr/rc#standards) for the order of precedence used when searching for configuration files. Our app is `ipfs-npm`.
+ipfs-npm uses [`rc`](https://github.com/dominictarr/rc) to parse configuration files. Please see the [`rc` repository](https://github.com/dominictarr/rc#standards) for the order of precedence used when searching for configuration files. The app is `ipfs-npm`.
 
 For instance, if you want to always use a remote daemon, you could create a `~/.ipfs-npmrc` file like this:
 
@@ -131,3 +129,18 @@ For instance, if you want to always use a remote daemon, you could create a `~/.
   "ipfsNode": "/ip4/127.0.0.1/tcp/5001"
 }
 ```
+
+## To learn more
+
+[Protocol Labs](https://protocol.ai), the organization behind IPFS, is actively working on improving the landscape for package managers and the distributed web in 2019 and beyond. To that end, we've created an [IPFS Package Managers Special Interest Group](https://github.com/ipfs/package-managers), and your feedback and contributions are very welcome!
+
+If you're actively (or just casually) using npm-on-ipfs and have feedback about your user experience, we'd love to hear from you, too. Please open an issue in the [Special Interest Group](https://github.com/ipfs/package-managers) and we'll get right back to you.
+
+More resources you may find useful:
+- [The original npm-on-ipfs demo video](https://vimeo.com/147968322)
+- [A more detailed introduction to npm-on-ipfs from David Dias' blog](http://daviddias.me/blog/stellar-module-management/)
+- [Node.js Interactive talk on Stellar Module Management, aka npm-on-ipfs](https://www.youtube.com/watch?v=-S-Tc7Gl8FM)
+
+## Lead maintainer
+
+[Alex Potsides](https://github.com/achingbrain)