Update README.md

Author: minuscorp

README.md

@@ -1,5 +1,9 @@
 # ModuleInterface
 [![Build Status](https://travis-ci.org/minuscorp/ModuleInterface.svg?branch=master)](https://travis-ci.org/minuscorp/ModuleInterface)
+![GitHub release (latest by date)](https://img.shields.io/github/v/release/minuscorp/ModuleInterface)
+![License](https://img.shields.io/static/v1?label=License&message=Apache&color=blue)
+![Swift version](https://img.shields.io/badge/Swift-5.1-orange)
+![Twitter Follow](https://img.shields.io/twitter/follow/minuscorp?style=social)
 
 Swift tool to generate Module Interfaces for Swift projects.
 
@@ -26,6 +30,83 @@ help       Display general or command-specific help
 version    Display the current version of ModuleInterface
 ```
 
-Typing `moduleinterfacep` help <command> we get a list of all options for that command
+Typing `moduleinterfacep` help <command> we get a list of all options for that command:
 
+```
+Generates the Swift Module Interface.
+
+[--spm-module (string)]
+	Generate documentation for Swift Package Manager module.
+
+[--module-name (string)]
+	Generate documentation for a Swift module.
+
+[--input-folder (string)]
+	Path to the input directory (defaults to /Users/minuscorp/Documents/GitHub/ModuleInterface).
+
+[--output-folder (string)]
+	Output directory (defaults to Documentation).
+
+[--min-acl (string)]
+	The minimum access level to generate documentation. Defaults to public.
+
+--clean|-c
+	Delete output folder before generating documentation.
+
+[[]]
+	List of arguments to pass to xcodebuild.
+```
+
+Usually, for most Xcode projects, no parameters are needed at all. xcodebuild should be able to find the default project and scheme.
+
+If the command fails, try specifying the scheme (-scheme SchemeName) or the workspace. Any arguments passed to sourcedocs after -- will be passed to xcodebuild without modification.
+
+`$ moduleinterface generate -- -scheme MyScheme`
+
+For Swift Package Manager modules, you can the module name using the --spm-module parameter.
+
+`$ moduleinterface generate --spm-module ModuleInterface`
+
+## Installation
+
+### Download Binary
+
+```
+$ curl -Ls https://github.com/minuscorp/ModuleInterface/releases/download/latest/moduleinterface.macos.zip -o /tmp/moduleinterface.macos.zip
+$ unzip -j -d /usr/local/bin /tmp/moduleinterface.macos.zip 
+```
+
+### From Sources
+Requirements:
+
+Swift 5.1 runtime and Xcode installed in your computer.
+
+### Using Homebrew
+
+**Soon**
+
+### Building with Swift Package Manager
+
+```
+$ git clone https://github.com/minuscorp/ModuleInterface.git
+$ cd ModuleInterface
+$ make
+```
+
+## Contact
+
+Follow and contact me on Twitter at [@minuscorp](https://twitter.com/minuscorp).
+
+## Contributions
+
+If you find an issue, just [open a ticket](https://github.com/minuscorp/ModuleInterface/issues/new) on it. Pull requests are warmly welcome as well.
+
+## License
+
+ModuleInterface is licensed under the Apache 2.0. See [LICENSE](https://github.com/minuscorp/ModuleInterface/blob/master/LICENSE) for more info.
+
+## Acknowledegments
 
+- To [@eneko](https://twitter.com/eneko) for giving me the tooling idea.
+- To [SourceKitten](https://github.com/jpsim/SourceKitten) for providing such an awesome Framework for dealing with SourceKit.
+- To [BQ](https://github.com/bq) for all the mentoring.