update readme

Author: rose-a

FluentAssertions.Reactive.sln

@@ -17,6 +17,11 @@ EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{0593589C-673C-47EB-8B56-E6B83DA2580E}"
 	ProjectSection(SolutionItems) = preProject
 		.editorconfig = .editorconfig
+		.gitattributes = .gitattributes
+		.gitignore = .gitignore
+		GitVersion.yml = GitVersion.yml
+		global.json = global.json
+		README.md = README.md
 	EndProjectSection
 EndProject
 Global

README.md

@@ -1,3 +1,23 @@
 # FluentAssertions.Reactive
 
-FluentAssertions for Observables 
+[![Nuget](https://img.shields.io/nuget/dt/FluentAssertions.Reactive)](https://www.nuget.org/packages/FluentAssertions.Reactive/)
+[![Nuget](https://img.shields.io/nuget/vpre/FluentAssertions.Reactive)](https://www.nuget.org/packages/FluentAssertions.Reactive)
+
+Extensions for the [Fluent Assertions](https://www.fluentassertions.com) for testing the behaviour of observables.
+
+## Example Usage
+
+```csharp
+var observable = Observable.Empty<Unit>();
+
+// observe the sequence
+using var observer = observable.Observe();
+
+// assert the behaviour of the sequence
+observer.Should().Complete();
+
+```
+
+More examples can be found in the [unit tests](https://github.com/fluentassertions/fluentassertions.reactive/blob/master/Tests/FluentAssertions.Reactive.Specs/ReactiveAssertionSpecs.cs)
+
+