Better docs

README.md

@@ -3,6 +3,12 @@ Transform your JSON Schema draft-07 to OpenAPI 3.0
 [![Build Status](https://travis-ci.org/bunyk/jsonschema2openapi.svg?branch=master)](https://travis-ci.org/bunyk/jsonschema2openapi)
 [![GoDoc](https://godoc.org/github.com/bunyk/jsonschema2openapi?status.svg)](https://godoc.org/github.com/bunyk/jsonschema2openapi)
 
+PutSchemaIntoOpenAPI will put `definitions` from provided JSON Schema into your OpenAPI 3.0 specification `component.schemas`. Also it will
+* Cleanup any `$schema` or other keys from JSON Reference objects
+* Any reference to `#/definitions` will lead to `#/component/schemas`
+* `"oneOf": [{"type": X}, {"type": "null"}]` will be replaced with `"type": X, "nullable": true`
+* TODO: finish doc
+
 ## Installation
 
 ```
@@ -12,15 +18,20 @@ go get github.com/bunyk/jsonschema2openapi
 ## Usage example
 
 ```go
-
-package main
-
 import (
     "fmt"
     "github.com/bunyk/jsonschema2openapi"
 )
 
-func main() {
+..
+
+APISpec, err := PutSchemaIntoOpenAPI(schema, openapitemplate)
+if err == nil {
+    fmt.Println(APISpec)
+} else {
+    fmt.Println(err.Error())
 }
 
+See more complete example in docs: https://godoc.org/github.com/bunyk/jsonschema2openapi#PutSchemaIntoOpenAPI
+
 ```