Correct OpenAPI version references to 3.1.0

Author: NyxStack

AGENTS.md

@@ -133,7 +133,8 @@ schema := &openapi.Schema{
 - User wants GraphQL schema
 - Only need simple HTTP client
 - Building non-API applications
-- User expects automatic generation (this is manual construction)
+
+**Note**: If user wants automatic generation, this package is perfect as the foundation - use these types to build generation tools!
 
 ### Common Mistakes to Avoid
 - **Missing Required Fields**: Always set `Type` in schemas

README.md

@@ -1,6 +1,18 @@
 # OpenAPI Package
 
-Go types and utilities for building OpenAPI 3.0 specifications programmatically.
+Go types and utilities for building OpenAPI 3.1.0 specifications programmatically.
+
+## Features
+
+### Supported OpenAPI 3.1.0 Features
+
+- ✅ **Complete Specification Support** - All OpenAPI 3.1.0 objects implemented
+- ✅ **JSON Schema Integration** - Full schema validation and documentation
+- ✅ **Multiple Content Types** - JSON, XML, form data, file uploads
+- ✅ **Authentication Schemes** - API keys, OAuth2, HTTP auth
+- ✅ **Response Linking** - Connect operations through links
+- ✅ **Webhooks & Callbacks** - Document async operations
+- ✅ **Examples & Descriptions** - Rich documentation with examples
 
 ## Installation
 
@@ -10,7 +22,7 @@ go get github.com/nyxstack/openapi
 
 ## Overview
 
-This package provides Go types that represent the complete OpenAPI 3.0 specification. You use these types to programmatically build OpenAPI documents, then marshal them to JSON or YAML format.
+This package provides Go types that represent the complete OpenAPI 3.1.0 specification. You use these types to programmatically build OpenAPI documents, then marshal them to JSON or YAML format.
 
 ## Usage
 

doc.go

@@ -1,6 +1,6 @@
-// Package openapi provides Go types and utilities for building OpenAPI 3.0 specifications.
+// Package openapi provides Go types and utilities for building OpenAPI 3.1.0 specifications.
 //
-// This package implements the complete OpenAPI 3.0 specification as Go structs,
+// This package implements the complete OpenAPI 3.1.0 specification as Go structs,
 // allowing you to programmatically build OpenAPI documents and marshal them to JSON or YAML.
 //
 // Basic usage:
@@ -17,6 +17,6 @@
 //		// handle error
 //	}
 //
-// The package supports all OpenAPI 3.0 features including schemas, parameters,
+// The package supports all OpenAPI 3.1.0 features including schemas, parameters,
 // responses, security schemes, callbacks, links, and more.
 package openapi

example/main.go

@@ -25,7 +25,7 @@ func buildCompleteAPI() *openapi.Document {
 	doc := openapi.NewDocument("Pet Store API", "1.0.0")
 
 	// Add metadata
-	doc.WithInfo("A sample Pet Store Server based on the OpenAPI 3.0 specification", "http://swagger.io/terms/").
+	doc.WithInfo("A sample Pet Store Server based on the OpenAPI 3.1.0 specification", "http://swagger.io/terms/").
 		WithContact("API Support", "http://www.swagger.io/support", "support@swagger.io").
 		WithLicense("Apache 2.0", "http://www.apache.org/licenses/LICENSE-2.0.html")