add some extra structures

Author: casualjim

.gitignore

@@ -1,2 +1,3 @@
 secrets.yml
 coverage.out
+.idea

README.md

@@ -2,4 +2,7 @@
 
 [![license](http://img.shields.io/badge/license-Apache%20v2-orange.svg)](https://raw.githubusercontent.com/go-openapi/spec3/master/LICENSE) [![GoDoc](https://godoc.org/github.com/go-openapi/spec3?status.svg)](http://godoc.org/github.com/go-openapi/spec3)
 
-The object model for OpenAPI specification v3 documents
+The object model for OpenAPI specification v3 documents.
+
+It aims to fix some mistakes that were made in the spec for v2. Top-level maps are now sorted by default so you can rely on their ordering.
+

contact.go

@@ -0,0 +1,10 @@
+package spec3
+
+//easyjson:json
+type Contact struct {
+	VendorExtensible
+
+	Name  string
+	URL   string
+	Email string
+}

contact_easyjson.go

@@ -0,0 +1,8 @@
+package spec3
+
+//go:generate easyjson -all -omit_empty -lower_camel_case contact.go
+//go:generate easyjson -all -omit_empty -lower_camel_case license.go
+//go:generate easyjson -all -omit_empty -lower_camel_case info.go
+//go:generate easyjson -all -omit_empty -lower_camel_case server.go
+//go:generate easyjson -all -omit_empty -lower_camel_case external_documentation.go
+//go:generate easyjson -all -omit_empty -lower_camel_case tag.go

doc.go

@@ -95,6 +95,12 @@ func (e Extensions) GetInt64(key string) (int64, bool) {
 // GetStringSlice gets a string value from the extensions
 func (e Extensions) GetStringSlice(key string) ([]string, bool) {
 	if v, ok := e.GetOK(key); ok {
+		strv, ok := v.([]string) // get out quick
+		if ok {
+			return strv, ok
+		}
+
+		// do the thing
 		arr, ok := v.([]interface{})
 		if !ok {
 			return nil, false

extensions.go

@@ -0,0 +1,9 @@
+package spec3
+
+//easyjson:json
+type ExternalDocumentation struct {
+	VendorExtensible
+
+	Description string
+	URL         string
+}

external_documentation.go

@@ -0,0 +1,13 @@
+package spec3
+
+//easyjson:json
+type Info struct {
+	VendorExtensible
+
+	Title          string
+	Description    string
+	TermsOfService string
+	Contact        *Contact
+	License        *License
+	Version        string
+}