diff --git a/README.md b/README.md
index 8a048d8..7c6e4d7 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,47 @@
-FlinkChallenge
+# 🚲 FlinkChallenge - The Flink Challenge App
+
+A companion project to the
+[NSHipster article about Swift Documentation](https://nshipster.com/swift-documentation/).
+
+## Requirements
+
+- Xcode
+- Git 2.16.2+
+- Ruby 2.4.3+
+- [Cocoapods](https://cocoapods.org)
+
+## Generating Docs
+
+First, clone the repository by opening Terminal.app
+and running the following commands:
+
+```terminal
+$ git clone git@github.com:A01334390/FlinkChallenge.git
+$ cd FlinkChallenge
+$ cd FlinkChallenge
+```
+
+Next, download project dependencies with CocoaPods using the command:
+
+```terminal
+$ pod install
+```
+
+Use [Jazzy](https://github.com/realm/jazzy)
+to generate web pages from the documentation comments of this Swift project:
+
+```terminal
+$ bundle exec jazzy -o Docs
+```
+
+Now open the `index.html` from the `Docs` directory
+to view the generated documentation:
+
+```terminal
+$ open Docs/index.html
+```
+
+## License
+
+This project is released under a Copyright (C) 2020 Fernando Martin Garcia Del Angel License 
+See the LICENSE file for more info.