Update README

Author: ctreffs

README.md

@@ -2,8 +2,70 @@
 
 [![license](https://img.shields.io/badge/license-MIT-brightgreen.svg)](LICENSE)
 [![github CI](https://github.com/fireblade-engine/math/workflows/CI/badge.svg)](https://github.com/fireblade-engine/math/actions?query=workflow%3ACI)
+[![swift version](https://img.shields.io/badge/swift-5.1+-blue.svg)](https://swift.org/download)
+[![platforms](https://img.shields.io/badge/platforms-%20macOS%20|%20iOS%20|%20tvOS%20-blue.svg)](#)
+[![platforms](https://img.shields.io/badge/platforms-linux-blue.svg)](#)
+[![platform-webassembly](https://img.shields.io/badge/Platform-WebAssembly-blue.svg)](https://github.com/swiftwasm/swift#swiftwasm)
 
-A dependency free, lightweight, fast math library for 2D and 3D vectors, quaternions and matrices in Swift with (optional) SIMD support.
+
+A dependency free, lightweight, fast math library for 2D and 3D vectors, quaternions and matrices in Swift with (optional) SIMD support.  It is developed and maintained as part of the [Fireblade Game Engine project](https://github.com/fireblade-engine).
+
+
+## 🚀 Getting Started
+
+These instructions will get you a copy of the project up and running on your local machine and provide a code example.
+
+### 📋 Prerequisites
+
+* [Swift Package Manager (SPM)](https://github.com/apple/swift-package-manager)
+* [Swiftlint](https://github.com/realm/SwiftLint) for linting - (optional)
+* [SwiftEnv](https://swiftenv.fuller.li/) for Swift version management - (optional)
+
+### 💻 Installing
+
+Fireblade Math is available for all platforms that support [Swift 5.1](https://swift.org/) and higher and the [Swift Package Manager (SPM)](https://github.com/apple/swift-package-manager).
+
+Extend the following lines in your `Package.swift` file or use it to create a new project.
+
+```swift
+// swift-tools-version:5.1
+
+import PackageDescription
+
+let package = Package(
+    name: "YourPackageName",
+    dependencies: [
+        .package(url: "https://github.com/fireblade-engine/math.git", from: "0.9.0")
+    ],
+    targets: [
+        .target(
+            name: "YourTargetName",
+            dependencies: ["FirebladeMath"])
+    ]
+)
+
+```
+
+## 💁 How to contribute
+
+If you want to contribute please see the [CONTRIBUTION GUIDE](CONTRIBUTING.md) first. 
+
+To start your project contribution run these in your command line:
+
+1. `git clone git@github.com:fireblade-engine/math.git fireblade-math`
+2. `cd fireblade-math`
+3. `make setupEnvironment`
+
+Before commiting code please ensure to run:
+
+- `make precommit`
+
+This project is currently maintained by [@ctreffs](https://github.com/ctreffs).   
+See also the list of [contributors](https://github.com/fireblade-engine/math/contributors) who participated in this project.
+
+## 🔏 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details
 
 ## ♻ Alternatives