From 647260d17e9b0867d5087c071f03dae31596073c Mon Sep 17 00:00:00 2001
From: Eduard Llull <ellull@users.noreply.github.com>
Date: Tue, 28 Mar 2023 13:57:03 +0200
Subject: [PATCH 1/2] Update README.md

---
 README.md | 88 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 86 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 7cfd3a2..b8f79b3 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,86 @@
-# fastbreaker
-Fast circuit breaker implementation in Go
+fastbreaker
+===========
+
+[fastbreaker](https://github.com/bluekiri/fastbreaker) implements the [Circuit Breaker pattern](https://en.wikipedia.org/wiki/Circuit_breaker_design_pattern) in Go.
+
+Installation
+------------
+
+```
+go get github.com/bluekiri/fastbreaker
+```
+
+Usage
+-----
+
+The interface `fastbreaker.FastBreaker` is a state machine to prevent sending requests that are likely to fail.
+The function `fastbreaker.New` creates a new `fastbreaker.FastBreaker`.
+
+```go
+func fastbreaker.New(configuration fastbreaker.Configuration) fastbreaker.FastBreaker
+```
+
+You can configure `fastbreaker.FastBreaker` by the struct `fastbreaker.Configuration`:
+
+```go
+type Configuration struct {
+    NumBuckets      int
+    BucketDuration  time.Duration
+    DurationOfBreak time.Duration
+    ShouldTrip      ShouldTripFunc
+}
+```
+
+- `NumBuckets` is the number of buckets of the rolling window.
+  If `NumBuckets` is less than 1, the `fastbreaker.DefaultNumBuckets` is used.
+
+- `BucketDuration` is the duration (truncated to the second) of every bucket.
+  If `BucketDuration` is less than 1s, the `fastbreaker.DefaultBucketDuration` is used.
+
+- `DurationOfBreak` is the time (truncated to the second) of the open state, after which the state
+  becomes half-open.
+  If `DurationOfBreak` is less than 1s, the `fastbreaker.DefaultDurationOfBreak` is used.
+
+- `ShouldTrip` is called whenever a request fails in the closed state with the number of executions
+  and the number of failures.
+  If `ShouldTrip` returns true, `fastbreaker.FastBreaker` state becomes open.
+  If `ShouldTrip` is `nil`, `fastbreaker.DefaultShouldTrip` is used.
+  `fastbreaker.DefaultShouldTrip` returns true when the number of executions is greater than or equal
+  to 10 and at least half the number of executions have failed.
+
+Example
+-------
+
+```go
+var cb fastbreaker.FastBreaker
+
+func Get(url string) ([]byte, error) {
+	feedback, err := cb.Allow()
+	if err != nil {
+		return nil, err
+	}
+
+	resp, err := http.Get(url)
+	if err != nil {
+		feedback(false)
+		return nil, err
+	}
+
+	defer resp.Body.Close()
+	body, err := ioutil.ReadAll(resp.Body)
+	if err != nil {
+		feedback(false)
+		return nil, err
+	}
+
+	feedback(true)
+	return body, nil
+}
+```
+
+License
+-------
+
+The MIT License (MIT)
+
+See [LICENSE](https://github.com/bluekiri/fastbreaker/blob/master/LICENSE) for details.

From eff6bb8e2a88ce8dc4efaf74e9153a2f5be555be Mon Sep 17 00:00:00 2001
From: Eduard Llull <ellull@users.noreply.github.com>
Date: Tue, 28 Mar 2023 15:56:41 +0200
Subject: [PATCH 2/2] add documentation badge

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index b8f79b3..3b5dc11 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,8 @@
 fastbreaker
 ===========
 
+[![Go Reference](https://pkg.go.dev/badge/github.com/bluekiri/fastbreaker.svg)](https://pkg.go.dev/github.com/bluekiri/fastbreaker)
+
 [fastbreaker](https://github.com/bluekiri/fastbreaker) implements the [Circuit Breaker pattern](https://en.wikipedia.org/wiki/Circuit_breaker_design_pattern) in Go.
 
 Installation