From ce0e55ee9b2fe289c9c7ed5053201cd0c764ab00 Mon Sep 17 00:00:00 2001
From: Joel Marcey <joelm@fb.com>
Date: Tue, 3 Oct 2017 15:24:38 -0700
Subject: [PATCH] Admin: How to publish to npm (#107)

This starts our admin section of docs, in .md format
---
 admin/publish.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 admin/publish.md

diff --git a/admin/publish.md b/admin/publish.md
new file mode 100644
index 0000000000..4fd9490b9e
--- /dev/null
+++ b/admin/publish.md
@@ -0,0 +1,32 @@
+Docusaurus is published as an npm package that can be installed via `npm` or `yarn`. Here is how you publish the package to npm:
+
+## Log in to npm
+
+Publishing will only work if you are logged into npm with an account with admin rights to the package.
+
+If you are not currently logged into npm locally:
+
+1. `npm adduser`
+1. Enter username, password and associated email address
+
+## Publish
+
+1. Bump version number in `package.json`
+2. `npm publish`
+
+### What version should you use?
+
+The version number should generally increase by some factor than the current one. You can check current version by looking in `package.json`.
+
+```
+"name": "docusaurus",
+"version": "1.0.0-alpha.41",
+"repository": {
+  "type": "git",
+  "url": "https://github.com/facebookexperimental/Docusaurus.git"
+},
+```
+
+For the above example, you may want to bump the version to `1.0.0-alpha.42` or `1.0.0-beta.1` or `1.0.1`.
+
+You can also see the full list of all published versions with `npm show docusaurus versions --json`.