Logo (#4)

* first version

* extended readme

* smilies

* tests screenshot, created img directory, md help

* rearrange installations

* update external help

Author: iricigor

Docs/Get-GitModule.md

@@ -8,7 +8,8 @@ schema: 2.0.0
 # Get-GitModule
 
 ## SYNOPSIS
-{{Fill in the Synopsis}}
+
+This cmdlet will check for existence of PowerShell module in given repository and return its version.
 
 ## SYNTAX
 
@@ -17,7 +18,13 @@ Get-GitModule [-ProjectUri] <String[]> [-Branch <String>] [-KeepTempCopy] [<Comm
 ```
 
 ## DESCRIPTION
-{{Fill in the Description}}
+
+This cmdlet will check for existence of PowerShell module in given repository and return its version.
+You can also specify desired git branch.
+
+Cmdlet requires `git` tool to work.
+It will download (`git clone`) specified repository to temporary repository and analyze it.
+By default, it will delete this temporary copy, but if needed, it can be kept.
 
 ## EXAMPLES
 

README.md

@@ -1,48 +1,61 @@
-# InstallGitModule
+<img align="right" width="203" height="294" src="img/InstallGitModule.logo.png">
 
-Helps installing modules directly from GitHub or Azure DevOps
+# Install Git Module
+
+:bowtie: This PowerShell module will be help you to easily instal PowerShell modules directly from Azure DevOps (aka VSTS) or GitHub.
+All you need to know is a URL of the git repository and the module will take care of everything else.
 
 ## Prerequisites
 
-* **git** - it must be installed and available on path
+* :exclamation: **git** - Git must be installed and available on path. If you don't have it, you can get it for example from [git-scm.com](https://git-scm.com/downloads).
 
 ## Installation
 
+### from PowerShell gallery
+
+:dash: _(not yet available)_
+
 ### clone GitHub repository
 
 ```PowerShell
 git clone https://github.com/iricigor/InstallGitModule
 Import-Module ./InstallGitModule/InstallGitModule.psd1
-```
+# and this is the last time you will be doing it like this
 
-### from PowerShell gallery
-
-_(not yet available)_
+# after you install this module you can do it like this
+Install-GitModule https://github.com/iricigor/InstallGitModule
+```
 
 ## Examples
 
 ```PowerShell
+# Check for module existence and its version
 C:> Get-GitModule 'https://github.com/iricigor/FIFA2018' -Verbose
 
-C:> Install-GitModule 'https://github.com/iricigor/psaptgetupdate' -Force | Select -Expand Name | Import-Module
+# Download and import module in one line
+C:> (Install-GitModule 'https://github.com/iricigor/psaptgetupdate').Name | Import-Module
 ```
 
 ## Commands
 
 ### Get-GitModule
 
+Checks for module existence and returns its version. More info [here](/Docs/Get-GitModule.md).
+
 ### Install-GitModule
 
+Installs PowerShell module to user's default install folder. More info [here](/Docs/Install-GitModule.md).
+
 ## Tests
 
-So far testing is very basic.
+:smirk: So far the module have very very basic testing, but it is doing that against two platforms - Linux and Windows. Tests results are available on Tests tab ([example here](/img/TestResults-AzureDevops.png)).
 
 Windows build status [![Build Status](https://dev.azure.com/iiric/PS1/_apis/build/status/InstallGitModule%20-%20Win%20CI?branchName=master)](https://dev.azure.com/iiric/PS1/_build/latest?definitionId=16&branchName=master)
 
 Linux build status [![Build Status](https://dev.azure.com/iiric/PS1/_apis/build/status/InstallGitModule%20-%20Linux%20CI?branchName=master)](https://dev.azure.com/iiric/PS1/_build/latest?definitionId=17&branchName=master)
 
 _Click on images to see details about latest build runs._
 
-## Similar versions
+## Similar PowerShell modules
 
-[dfinke](https://github.com/dfinke)/[InstallModuleFromGitHub](https://github.com/dfinke/InstallModuleFromGitHub)
+:mega: [dfinke](https://github.com/dfinke)/[InstallModuleFromGitHub](https://github.com/dfinke/InstallModuleFromGitHub)

en-US/InstallGitModule-help.xml

@@ -6,11 +6,12 @@
       <command:verb>Get</command:verb>
       <command:noun>GitModule</command:noun>
       <maml:description>
-        <maml:para>{{Fill in the Synopsis}}</maml:para>
+        <maml:para>This cmdlet will check for existence of PowerShell module in given repository and return its version.</maml:para>
       </maml:description>
     </command:details>
     <maml:description>
-      <maml:para>{{Fill in the Description}}</maml:para>
+      <maml:para>This cmdlet will check for existence of PowerShell module in given repository and return its version. You can also specify desired git branch.</maml:para>
+      <maml:para>Cmdlet requires `git` tool to work. It will download (`git clone`) specified repository to temporary repository and analyze it. By default, it will delete this temporary copy, but if needed, it can be kept.</maml:para>
     </maml:description>
     <command:syntax>
       <command:syntaxItem>