diff --git a/README.md b/README.md
index 438a0fd..428a902 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,53 @@
 # Script Launcher
 
-Find executable scripts in a directory and allow to select which one to execute
+Find executable scripts in a directory and allow to select which one to execute.
+
+## Installation
+
+### As .NET CLI Tool
+
+To be installed as a tool, you need the [.NET CLI][CLI] which is included in the [.NET SDK][SDK]
+
+Install manually using the following commands or by using the provided installation scripts.
+
+```sh
+dotnet pack ./src -o ./nupkg
+dotnet tool install -g ScriptLauncher --add-source ./nupkg --ignore-failed-sources
+```
+
+### As a Standalone Executable
+
+You will need the identifier of the .NET Runtime ([RID]) and the Target Framework Moniker ([TFM]) for your OS and Runtime.  
+
+```sh
+# self contained: will not need the .NET runtime to function, bigger resulting size
+dotnet publish -c Release --self-contained -p:PublishSingleFile=true -p:PublishTrimmed=true -f <TFM> -r <RID> -o <output-directory> ./src
+
+# no self contained: will need the .NET runtime to be installed to function, smallest size
+dotnet publish -c Release --no-self-contained -p:PublishSingleFile=true -r <RID> -o <output-directory> ./src
+```
+
+_**NOTE**_: The option `-p:PublishTrimmed=true` may produce some *warnings*. If so simply skip that option and the resulting executable will be larger
+
+## Usage
+
+```sh
+Usage: script-launcher [--extensions <String>] [--depth <Int32>] [--elevated] [--group] [--brief] [--help] [--version] directory
+
+Arguments:
+  0: directory    Starting directory (Default: .)
+
+Options:
+  -x, --extensions <String>    Comma separated list of script extensions
+  -d, --depth <Int32>          Search depth (Default: 1)
+  -e, --elevated               Run with elevated privileges
+  -g, --group                  Group scripts by folder
+  -b, --brief                  Show brief information
+  -h, --help                   Show help message
+  --version                    Show version
+```
+
+[CLI]: https://docs.microsoft.com/en-us/dotnet/core/tools/ ".NET CLI Docs"
+[SDK]: https://dotnet.microsoft.com/en-us/download ".NET SDK Downloads"
+[RID]: https://docs.microsoft.com/en-us/dotnet/core/rid-catalog "Runtime IDs Catalog"
+[TFM]: https://docs.microsoft.com/en-us/dotnet/standard/frameworks "Target Framework Moniker Docs"
diff --git a/dotnet-publish.ps1 b/dotnet-publish.ps1
deleted file mode 100644
index 43860c0..0000000
--- a/dotnet-publish.ps1
+++ /dev/null
@@ -1,26 +0,0 @@
-function Get-Runtime
-{
-    if($isLinux)
-    {
-        return "linux-x64";
-    }
-
-    if($isMac)
-    {
-        return "osx-x64";
-    }
-
-    if($isWindows)
-    {
-        return "win-x64";
-    }
-
-    return $null;
-}
-
-$runtime = Get-Runtime;
-
-if($runtime -ne $null)
-{
-    dotnet publish -o out -c Release --self-contained -p:PublishSingleFile=true -p:PublishTrimmed=true -f net6.0 -r $runtime .\src\
-}
\ No newline at end of file
diff --git a/dotnet-install-tool.ps1 b/install-as-dotnet-tool.ps1
similarity index 100%
rename from dotnet-install-tool.ps1
rename to install-as-dotnet-tool.ps1
diff --git a/dotnet-install-tool.sh b/install-as-dotnet-tool.sh
old mode 100644
new mode 100755
similarity index 82%
rename from dotnet-install-tool.sh
rename to install-as-dotnet-tool.sh
index bf94705..4b0924f
--- a/dotnet-install-tool.sh
+++ b/install-as-dotnet-tool.sh
@@ -1,10 +1,10 @@
-#! /usr/bin/env bash
+#!/usr/bin/env bash
 
 dotnet pack ./src -o ./nupkg
 
 EXISTS=$(command -v script-launcher)
 
-if $EXISTS; then 
+if [ "$EXISTS" ]; then 
     ACTION="update"
 else 
     ACTION="install"