[README] Major rewrite & links to help

Author: achilleas-k

README.md

@@ -1,4 +1,4 @@
-# GIN-cli
+# GIN-CLI
 
 [![GoDoc](https://godoc.org/github.com/G-Node/gin-cli?status.svg)](http://godoc.org/github.com/G-Node/gin-cli)
 
@@ -7,103 +7,18 @@
 
 ---
 
-**G**-Node **In**frastructure command line client
+**G**-Node **In**frastructure **C**ommand **L**ine **C**lient
 
 This package is a command line client for interfacing with repositories hosted on [GIN](https://gin.g-node.org).
-It offers a simplified interface for downloading and uploading files from repositories hosted on Gin.
-For a guide on how to use the GIN service and this client, see the [GIN quick start](https://web.gin.g-node.org/G-Node/Info/wiki/Quick+start) page.
+It offers a simplified interface for downloading and uploading files from repositories hosted on GIN.
 
-## Usage
+It consists of commands for interfacing with the GIN web API (e.g., listing repositories, creating repositories, managing SSH keys) but primarily, it wraps **git** and **git-annex** commands to make working with data repositories easier.
 
-The following is a description of the available commands in the GIN client.
-In the command line, you can view a basic list of commands by running
-
-    gin -h
-
-You can also run
-
-    gin help <cmd>
-
-to get the full description of any command.
-
-The table below describes the commands and their arguments.
-Please note:
-- Arguments enclosed in square brackets (e.g., `[<filenames>]`) are optional.
-    - Generally, when a command specifies that it accepts `[<filenames>]` it means the user can limit the application of the command to specific filenames and directories. Multiple arguments may be specified (separated by space). If none are listed, the command will apply to all files and directories below the _current working directory_.
-- Arguments listed together separated by a pipe (e.g., `--here | --no-clone`) denotes that the two options cannot be specified at the same time.
-
-GIN command line client
-
-Usage:
-
-	gin <command> [<args>...]
-	gin --help
-	gin --version
-
-Options:
-
-	-h --help    This help screen
-	--version    Client version
-
-Commands:
-
-	login          [<username>]
-		Login to the GIN services
-
-	logout
-		Logout from the GIN services
-
-	create         [--here | --no-clone] [<name>] [<description>]
-		Create a repository on the remote server and clone it
-
-	get            <repopath>
-		Retrieve (clone) a repository from the remote server
-
-	ls             [-s | --short | --json] [<filenames>]
-		List the sync status of files in a local repository
-
-	unlock         [<filenames>]
-		Unlock files for editing
-
-	lock           [<filenames>]
-		Lock files
-
-	upload         [<filenames>]
-		Upload local changes to a remote repository
-
-	download       [--content]
-		Download all new information from a remote repository
-
-	get-content    [<filenames>]
-		Download the content of files from a remote repository
-
-	getc           [<filenames>]
-		Synonym for get-content
-
-	remove-content [<filenames>]
-		Remove the content of local files that have already been uploaded
-
-	rmc            [<filenames>]
-		Synonym for remove-content
-
-	repos          [--shared | --all]
-		List remote repositories
-
-	repos          [<username>]
-		List available remote repositories for specific user
-
-	info           [<username>]
-		Print user information
-
-	keys           [-v | --verbose]
-		List the keys associated with the logged in user
-
-	keys           --add <filename>
-		Add/upload a new public key to the GIN services
-
-	help           <command>
-		Get help for individual commands
-
-
-Use 'help' followed by a command to see full description of the command.
+## Information, setup, and guides
+For installation instructions see the [GIN Client Setup](https://web.gin.g-node.org/G-Node/Info/wiki/GinCli) page.
 
+General information, help, and guides for using GIN can be found on the [GIN Info Wiki](https://web.gin.g-node.org/G-Node/info/wiki).
+Help and information for the client in particular can be on the following pages:
+- [Usage guide (tutorial)](https://web.gin.g-node.org/G-Node/Info/wiki/GinUsageTutorial)
+- [Useful recipes and short workflows](https://web.gin.g-node.org/G-Node/Info/wiki/GinCliRecipes)
+- [Detailed command overview](https://web.gin.g-node.org/G-Node/Info/wiki/GinClientHelp)