From b34594681b73e3b6b5c473407a34bd7b1bc2dc75 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fernando=20Mart=C3=ADn=20Garc=C3=ADa=20Del=20Angel?= Date: Wed, 19 Feb 2020 20:08:53 -0600 Subject: [PATCH] Update README.md --- README.md | 48 +++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 47 insertions(+), 1 deletion(-) 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.