From bcebfee5425024f377e4e9c8f07803daa0ff73f9 Mon Sep 17 00:00:00 2001
From: Ivan Ilves <ivan.ilves@schibsted.com>
Date: Sun, 18 Mar 2018 19:21:19 +0100
Subject: [PATCH 1/2] NORELEASE Use ellipsis string instead of slice

---
 api/v1/v1.go      | 2 +-
 api/v1/v1_test.go | 2 +-
 main.go           | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/api/v1/v1.go b/api/v1/v1.go
index 54a5d1b..90fb066 100644
--- a/api/v1/v1.go
+++ b/api/v1/v1.go
@@ -60,7 +60,7 @@ func fn(labels ...string) string {
 
 // CollectTags collects information on tags present in remote registry and [local] Docker daemon,
 // makes required comparisons between them and spits organized info back as collection.Collection
-func (api *API) CollectTags(refs []string) (*collection.Collection, error) {
+func (api *API) CollectTags(refs ...string) (*collection.Collection, error) {
 	if len(refs) == 0 {
 		return nil, fmt.Errorf("no image references passed")
 	}
diff --git a/api/v1/v1_test.go b/api/v1/v1_test.go
index 5faa7c4..78afb96 100644
--- a/api/v1/v1_test.go
+++ b/api/v1/v1_test.go
@@ -17,7 +17,7 @@ func runEnd2EndJob(pullRefs, seedRefs []string) ([]string, error) {
 		return nil, err
 	}
 
-	collection, err := api.CollectTags(pullRefs)
+	collection, err := api.CollectTags(pullRefs...)
 	if err != nil {
 		return nil, err
 	}
diff --git a/main.go b/main.go
index 928782c..5bf04d8 100644
--- a/main.go
+++ b/main.go
@@ -99,7 +99,7 @@ func main() {
 		suicide(err, true)
 	}
 
-	collection, err := api.CollectTags(o.Positional.Repositories)
+	collection, err := api.CollectTags(o.Positional.Repositories...)
 	if err != nil {
 		suicide(err, true)
 	}

From db9ca0500b8af6f9e218dd57a8742401df0d9cc7 Mon Sep 17 00:00:00 2001
From: Ivan Ilves <ivan.ilves@schibsted.com>
Date: Sun, 18 Mar 2018 19:28:43 +0100
Subject: [PATCH 2/2] Update README.md to match stable release requirements

---
 README.md | 46 +++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 45 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 48440e4..436d4b3 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
 
 # L/S tags
 
-`lstags` is a utility and an **API** to manipulate (analyze, synchronize and aggregate) images across different Docker registries.
+`lstags` is a utility and an **[API](#api)** to manipulate (analyze, synchronize and aggregate) images across different Docker registries.
 
 ### Example invocation
 ```
@@ -146,3 +146,47 @@ To maximize our collaboration efficiency we would humbly ask you to follow these
 For the most cases it is OK. However, if you work with things that do not need to be released (e.g. non user-facing changes), you have following options:
 * If you don't want to create release from your PR, make it from branch containing "NORELEASE" keyword in its name.
 * If you want to prevent single commit from appearing in a changelog, please start commit message with "NORELEASE".
+
+#### Automatic releases are "preproduction" ones. They pass manual promotion :up: when we believe they are stable.
+
+:warning: We don't build RPMs/DEBs/etc, as we see no need for it. We ship `lstags` as a single binary or as a Docker container.
+
+## API
+
+You may use `lstags` either as a standalone CLI or as a Golang package inside your own application:
+
+### PoC application with our `v1` API
+```golang
+package main
+
+import (
+  "fmt"
+
+  "github.com/ivanilves/lstags/api/v1"
+)
+
+func main() {
+  api, _ := v1.New(v1.Config{})
+
+  collection, _ := api.CollectTags(
+    "alpine",
+    "nginx=latest,stable",
+    "gcr.io/google_containers/pause-amd64:3.1",
+    "quay.io/coreos/flannel~/v0.10/",
+  )
+
+  for _, repo := range collection.Repos() {
+    for _, tag := range collection.Tags(repo.Ref()) {
+      fmt.Printf(
+        "- %-40s %-15s %s %s\n",
+        repo.Name(),
+        tag.Name(),
+        tag.GetCreatedString(),
+        tag.GetState(),
+      )
+    }
+  }
+}
+```
+
+**NB!** Far more complete API usage example could be found in **[main.go](https://github.com/ivanilves/lstags/blob/master/main.go)** :wink: