Convert the old rST docs into the new md ones.

Closes #128

CHANGES/128.misc

@@ -0,0 +1 @@
+Convert the old docs to the new Markdown style.

README.md

@@ -1,5 +1,38 @@
 # pulp-npm
 
-A Pulp plugin to support hosting your own npm.
+<!--toc:start-->
+- [pulp-npm](#pulp-npm)
+  - [About Pulp](#about-pulp)
+  - [About pulp_npm](#about-pulpnpm)
+  - [License](#license)
+<!--toc:end-->
+
+A Pulp plugin to support npm packages.
 
 For more information, please see the [documentation](docs/index.rst) or the [Pulp project page](https://pulpproject.org/).
+
+## About Pulp
+Pulp is a platform for managing repositories of content, such as software
+packages, and pushing that content out to large numbers of consumers.
+
+Using Pulp you can:
+- Locally mirror all or part of a repository
+- Host your own content in a new repository
+- Manage content from multiple sources in one place
+- Promote content through different repos in an organized way
+
+## About pulp_npm
+The plugin pulp_npm currently supports mirroring one specific version of a package and make it available.
+Since the plugin is API compatible with the NPM Registry, you can use the `npm` CLI to download packages from Pulp.
+For ex:
+```
+npm install --registry http://localhost:5001/pulp/content/{domain}/npm/ react
+```
+
+We are working to support more ways of mirroring the NPM Registry and allow uploads of npm content to pulp_npm.
+
+## License
+- License: GPLv2+
+- Documentation: https://pulpproject.org/
+- Source: https://github.com/pulp/pulp_npm/
+- Bugs: https://github.com/pulp/pulp_npm/issues