README.md update

Author: sbrossie

README.md

@@ -4,20 +4,20 @@ and killbill command line tool (kbcmd)
 
 ## Versions
 
-| KB Version  | KBCli Version |
-| ----------- | ------------- |
-| 0.20.x      | 1.x.y         |
-| 0.22.x      | 2.x.y         |
+| KB Version | KBCli Version |
+|------------|---------------|
+| 0.20.x     | 1.x.y         |
+| 0.22.x     | 2.x.y         |
+| 0.24.x     | 3.x.y         |
 
 
 
 ## Kill bill go client library
-Kill bill go client library is a go package that can be used to connect to
-kill bill.
+Kill bill go client library is a go package that can be used to connect to Kill Bill server.
 
 ### Install
 ```bash
-go get -u github.com/killbill/kbcli/v2
+go get -u github.com/killbill/kbcli/v3
 ```
 
 ### Creating new client
@@ -47,56 +47,21 @@ go get -u github.com/killbill/kbcli/v2
 Look at the [complete example here](examples/listaccounts/main.go).
 For more examples, look at [kbcmd tool](kbcmd/README.md).
 
-### Client code generation
-
-This client code was generated by the [go-swagger tool](https://github.com/go-swagger/go-swagger).
-
-We use a modified generator and templates to generate the client, and the [sources are here](https://github.com/killbill/go-swagger).
-
-As explained in the [commit](https://github.com/killbill/go-swagger/commit/4d48bffe307c6043daccf5144b132c55cc783803), we are stuck
-on an older version of `go-swagger`, i.e our fork is not up to date with parent. In addition to this, there is an [issue](https://github.com/go-swagger/go-swagger/issues/2215) compiling
-the tool with recent version of go, and so we are aldo currently stuck using go <= 1.13 -- for building the tool itself, i.e the swagger generator.
-
-To download/install GO 1.13, follow the steps from [here](https://golang.org/doc/manage-install), or simply:
+### Wrapper client
 
-```bash
-# This will install the tool under  ~/sdk by default
-go get golang.org/dl/go1.13
-go1.13 download
-
-# You can then set GOROOT=~/sdk/go1.13 in your shell or inside Goland 's preference (for the project)
-```
+We also provide a client wrapper (a higher level and easier to use api) that is built (not generated) on top of the generated code.
+See the package `killbill` package under the `wrapper` directory.
 
-To build the (custom) swagger generator
-
-```bash
+There is a suite of test `client_test.go` that shows how to use it.
 
-# Pre-requisite (needed if template changes)
-brew install go-bindata
-
-# Install swagger tool
-mkdir -p $GOPATH/src/github.com/go-swagger
-cd $GOPATH/src/github.com/go-swagger
-git clone git@github.com:killbill/go-swagger.git
-
-# Each time the templates change, following 2 steps are needed:
-
-#1. Regenerate the (template) byte code inside the go-swagger code itself ->  generator/bindata.go should be modified
-go1.13 generate ./generator
-
-#2. build the binary
-go1.13 build cmd/swagger/swagger.go && cp swagger cp ./swagger $GOPATH/bin/swagger
-```
+### Client code generation
 
-Finally, in order to generate the killbill client (using the custom `swagger` generator):
+We use a forked version of the `go-swagger` client hosted under https://github.com/killbill/go-swagger.
+Every so often we rebase our fork from upstream to keep it up-to-date. Given a version of a `swagger` binary, the
+client can be regenarated using:
 
-```bash
-# Update swagger.json
-curl http://localhost:8080/swagger.json | jq "." >swagger.json
+`swagger  generate client -f kbswagger.yaml -m kbmodel -c kbclient --default-scheme=http`
 
-# Regenerate the tool
-swagger generate client -f swagger.json -m kbmodel -c kbclient --default-scheme=http
-```
 
 ### Generating dev extensions
 We also have dev extension APIs (like clock etc), that are in swagger-dev.json. To generate,