udpated docs for publish and run commands

docs/publish.md

@@ -5,12 +5,12 @@ title: bolt publish
 
 ---
 
-Publish new version(s) of your package(s) to npm
+Publish new version of your package(s) on npm
 
-### `publish-lock`
+*Once a package is published, you can never modify that specific version, so take care before publishing.*
 
-Lock your package(s) on the npm registry
+## Commands
 
-### `publish-unlock`
+### **`bolt publish`**
 
-Unlock your package(s) on the npm registry
+This will visit every workspace in the repository and try to publish workspace which has version greater than already published version.

docs/run.md

@@ -5,4 +5,38 @@ title: bolt run
 
 ---
 
-`bolt run [script]` Run a script in a package
+Runs a defined package script.
+
+You may define [scripts](https://yarnpkg.com/en/docs/package-json#toc-scripts) in your repository's [package.json](https://yarnpkg.com/en/docs/package-json) file.
+
+```
+{
+  "name": "my-package",
+  "scripts": {
+    "build": "babel src -d lib",
+    "test": "jest"
+  }
+}
+```
+
+## Commands
+
+### **bolt run \<script\> [arguments]**
+
+This will run the script defined in your package json. All the arguments are passed down to the script. For example:
+
+```
+bolt run test
+```
+
+You can pass arguments to the script by keeping them after the command. For example, to run *jest* in watch mode:
+
+```
+bolt run test --watch
+```
+
+## Related commands
+
+[`bolt workspace run`](/docs/workspace-run.html)
+
+[`bolt workspaces run`](/docs/workspaces-run.html)