Docs: fix requirements for resin ssh and resin sync

change-type: patch

README.md

@@ -12,6 +12,20 @@ Requisites
 
 - [NodeJS](https://nodejs.org) (at least v0.10)
 - [Git](https://git-scm.com)
+- The following executables should be correctly installed in your shell environment:
+  - `ssh`: Any recent version of the OpenSSH ssh client (required by `resin sync` and `resin ssh`)
+  - `rsync`: >= 2.6.9 (required by `resin sync`)
+
+##### Windows Support
+
+`resin sync` and `resin ssh` have not been thoroughly tested on the standard Windows cmd.exe shell. We recommend using bash (or a similar) shell, like Bash for Windows 10 or Git Bash.
+
+If you still want to use `cmd.exe` you will have to use a package manager like MinGW or chocolatey. For MinGW the steps are:
+
+1. Install [MinGW](http://www.mingw.org).
+2. Install the `msys-rsync` and `msys-openssh` packages.
+3. Add MinGW to the `%PATH%` if this hasn't been done by the installer already. The location where the binaries are places is usually `C:\MinGW\msys\1.0\bin`, but it can vary if you selected a different location in the installer.
+4. Copy your SSH keys to `%homedrive%%homepath\.ssh`.
 
 Getting Started
 ---------------

capitanodoc.json

@@ -1,6 +1,6 @@
 {
 	"title": "Resin CLI Documentation",
-	"introduction": "This tool allows you to interact with the resin.io api from the comfort of your command line.\n\nTo get started download the CLI from npm.\n\n\t$ npm install resin-cli -g\n\nThen authenticate yourself:\n\n\t$ resin login\n\nNow you have access to all the commands referenced below.",
+	"introduction": "This tool allows you to interact with the resin.io api from the comfort of your command line.\n\nPlease make sure your system meets the requirements as specified in the [README](https://github.com/resin-io/resin-cli).\n\nTo get started download the CLI from npm.\n\n\t$ npm install resin-cli -g\n\nThen authenticate yourself:\n\n\t$ resin login\n\nNow you have access to all the commands referenced below.",
 	"categories": [
 		{
 			"title": "Application",

doc/cli.markdown

@@ -2,6 +2,8 @@
 
 This tool allows you to interact with the resin.io api from the comfort of your command line.
 
+Please make sure your system meets the requirements as specified in the [README](https://github.com/resin-io/resin-cli).
+
 To get started download the CLI from npm.
 
 	$ npm install resin-cli -g
@@ -342,7 +344,7 @@ Examples:
 
 ### Options
 
-#### --force, -f <force>
+#### --force, -f
 
 force action if the update lock is set
 
@@ -356,7 +358,7 @@ Examples:
 
 ### Options
 
-#### --force, -f <force>
+#### --force, -f
 
 force action if the update lock is set
 
@@ -650,7 +652,9 @@ continuously stream output
 
 ## sync [uuid]
 
-WARNING: If you're running Windows, this command only supports `cmd.exe`.
+Warning: 'resin sync' requires an openssh-compatible client and 'rsync' to
+be correctly installed in your shell environment. For more information (including
+Windows support) please check the README here: https://github.com/resin-io/resin-cli
 
 Use this command to sync your local changes to a certain device on the fly.
 
@@ -725,7 +729,9 @@ increase verbosity
 
 ## ssh [uuid]
 
-WARNING: If you're running Windows, this command only supports `cmd.exe`.
+Warning: 'resin ssh' requires an openssh-compatible client to be correctly
+installed in your shell environment. For more information (including Windows
+support) please check the README here: https://github.com/resin-io/resin-cli
 
 Use this command to get a shell into the running application container of
 your device.

lib/actions/ssh.coffee

@@ -39,7 +39,9 @@ module.exports =
 	signature: 'ssh [uuid]'
 	description: '(beta) get a shell into the running app container of a device'
 	help: '''
-		WARNING: If you're running Windows, this command only supports `cmd.exe`.
+		Warning: 'resin ssh' requires an openssh-compatible client to be correctly
+		installed in your shell environment. For more information (including Windows
+		support) please check the README here: https://github.com/resin-io/resin-cli
 
 		Use this command to get a shell into the running application container of
 		your device.

lib/actions/sync.coffee

@@ -44,7 +44,9 @@ module.exports =
 	signature: 'sync [uuid]'
 	description: '(beta) sync your changes to a device'
 	help: '''
-		WARNING: If you're running Windows, this command only supports `cmd.exe`.
+		Warning: 'resin sync' requires an openssh-compatible client and 'rsync' to
+		be correctly installed in your shell environment. For more information (including
+		Windows support) please check the README here: https://github.com/resin-io/resin-cli
 
 		Use this command to sync your local changes to a certain device on the fly.