diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9b07211..c7625be 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,11 @@
## Unreleased
+* Update the README with up-to-date Swift versions and Installation Instructions.
+ [@kuyazee](https://github.com/kuyazee)
+ [@AliSoftware](https://github.com/AliSoftware)
+ [#95](https://github.com/AliSoftware/Reusable/pull/95)
+
* Set `APPLICATION_EXTENSION_API_ONLY` build setting on built frameworks.
[@AliSoftware](https://github.com/AliSoftware)
[#98](https://github.com/AliSoftware/Reusable/pull/98)
diff --git a/README.md b/README.md
index 166f6b5..c688697 100644
--- a/README.md
+++ b/README.md
@@ -9,18 +9,72 @@ A Swift mixin to use `UITableViewCells`, `UICollectionViewCells` and `UIViewCont
[](https://circleci.com/gh/AliSoftware/Reusable/tree/master)
[](http://cocoadocs.org/docsets/Reusable)
[](http://cocoadocs.org/docsets/Reusable)
-[](https://swift.org)
+[](https://swift.org)
+[](https://swift.org)
+[](https://swift.org)
-# Requirements
+# Installation
+
+Requirements: which Reusable version to use for each Swift Version?
| Swift Version | Reusable Version |
|----------------|--------------------|
| 2.2 & 2.3 | 2.5.1 |
| 3.0 (†) | 3.0.0 + |
| 4.0 | 4.0.2 + |
+| 5.0 | 4.1.0 + |
_(†) The Reusable 3.0 code also compiles with Swift 4, you'll need 4.0.2+ only if you're using Carthage for integration_
+
+
+Reusable can be integrated to your Xcode projects using one of the following options:
+
+Installation instructions for Swift Package Manager (SPM)
+
+[Swift Package Manager](https://swift.org/package-manager/) is Apple's decentralized dependency manager to integrate libraries to your Swift projects. It is now fully integrated with Xcode 11
+
+To integrate Reusable into your project using SPM, specify it in your `Package.swift` file:
+
+```swift
+let package = Package(
+ …
+ dependencies: [
+ .package(url: "https://github.com/AliSoftware/Reusable.git", from: "4.1.0"),
+ ],
+ targets: [
+ .target(name: "YourTarget", dependencies: ["Reusable", …])
+ …
+ ]
+)
+```
+
+
+
+Installation instructions for Carthage
+
+[Carthage](https://github.com/Carthage/Carthage) is a decentralized dependency manager to add pre-built frameworks to your Cocoa application.
+
+To integrate Reusable into your Xcode project using Carthage, specify it in your `Cartfile`:
+
+```bash
+github "AliSoftware/Reusable"
+```
+
+
+
+Installation instructions for CocoaPods
+
+[CocoaPods](https://cocoapods.org/) is a dependency manager to automate integration of frameworks to your Swift and Objective-C Cocoa projects.
+
+To integrate Reusable into your Xcode project using Cocoapods, specify it in your `Podspec`:
+
+```bash
+pod 'Reusable'
+```
+
+
+
# Introduction
This library aims to make it super-easy to create, dequeue and instantiate reusable views anywhere this pattern is used: from the obvious `UITableViewCell` and `UICollectionViewCell` to custom `UIViews`, even supporting `UIViewControllers` from Storyboards.
@@ -459,6 +513,7 @@ The concepts behind Reusable has been presented in various articles and talks:
* [Using Generics to improve TableView cells](https://alisoftware.github.io/swift/generics/2016/01/06/generic-tableviewcells/) on my blog
* [FrenchKit'16 talk: Mixins over Inheritance](https://youtu.be/BSn4jlunn4I) (video)
* Same talk was also given at NSSpain'16 ([slides](https://speakerdeck.com/alisoftware/mixins-over-inheritance)) and AppDevCon'17 ([slides](https://speakerdeck.com/alisoftware/mixins-over-inheritance-appdevcon-17))
+* [No more String-typed instantiations on iOS Development](https://medium.com/@zonilyjame/reusable-no-more-string-typed-instantiations-on-ios-development-aa1a4f59201c)
# License