chore: update readme links and badges (#31)

Co-authored-by: Chai Landau <[email protected]>
Co-authored-by: Tristan Cartledge <[email protected]>
Co-authored-by: Tristan Cartledge <[email protected]>

Author: 3 people

README.md

@@ -18,13 +18,13 @@
     <img  width="200px" alt="OpenAPI" src="https://github.com/user-attachments/assets/555a0899-5719-42ee-b4b1-ece8d1d812ea">
   </p>
   <h1 align="center"><b>OpenAPI</b></h1>
-  <p align="center">A set of packages and tools for working with <a href="https://www.speakeasy.com/openapi">OpenAPI Specification documents</a>. <br /> Used directly in Speakeasy's product to power our <a href="https://www.speakeasy.com/docs/create-client-sdks">SDK Generator</a> and <a href="https://www.speakeasy.com/docs/testing">Contract Testing</a> tools.
+  <p align="center">A set of packages and tools for working with <a href="https://www.speakeasy.com/openapi">OpenAPI Specification documents</a>. <br /> Used directly in Speakeasy's product to power our <a href="https://www.speakeasy.com/product/sdk-generation">SDK Generation</a> and <a href="https://www.speakeasy.com/product/gram">Gram</a> products.
 
 </p>
   <p align="center">
     <!-- Badges -->
     <!-- OpenAPI Hub Badge -->
-    <a href="https://www.speakeasy.com/openapi"><img src="https://custom-icon-badges.demolab.com/badge/-OpenAPI%20Hub-212015?style=for-the-badge&logoColor=FBE331&logo=speakeasy&labelColor=545454" /></a>
+    <a href="https://www.speakeasy.com/openapi"><img alt="OpenAPI Hub" src="https://www.speakeasy.com/assets/badges/openapi-hub.svg" /></a>
     <!-- OpenAPI Support Badge -->
     <a href="https://www.speakeasy.com/openapi"><img alt="OpenAPI Support" src="https://img.shields.io/badge/OpenAPI-3.0%20%7C%203.1-85EA2D.svg?style=for-the-badge&logo=openapiinitiative"></a>
     <!-- Arazzo Support Badge -->
@@ -53,9 +53,9 @@
     <img alt="Go Install" src="https://img.shields.io/badge/go%20install-ready-00ADD8.svg?style=for-the-badge&logo=go">
     <!-- Line Break --><br/>
     <!-- Built By Speakeasy Badge -->
-    <a href="https://speakeasy.com/"><img src="https://custom-icon-badges.demolab.com/badge/-Built%20By%20Speakeasy-212015?style=for-the-badge&logoColor=FBE331&logo=speakeasy&labelColor=545454" /></a>
+    <a href="https://speakeasy.com/"><img alt="Built by Speakeasy" src="https://www.speakeasy.com/assets/badges/built-by-speakeasy.svg" /></a>
     <!-- License Badge -->
-    <a href="/LICENSE"><img alt="Software License" src="https://img.shields.io/badge/license-MIT-blue.svg?style=for-the-badge"></a>    
+    <a href="/LICENSE"><img alt="Software License" src="https://img.shields.io/badge/license-MIT-blue.svg?style=for-the-badge"></a>
   </p>
 </p>
 
@@ -155,4 +155,3 @@ This repository is maintained by Speakeasy, but we welcome and encourage contrib
 All contributions, whether they're bug reports, feature requests, or code changes, help make this project better for everyone.
 
 Please ensure your contributions adhere to our coding standards and include appropriate tests where applicable.
-

arazzo/README.md

@@ -6,8 +6,10 @@
   <p align="center">An API for working with <a href="https://www.speakeasy.com/openapi/arazzo">Arazzo documents</a> including: read, walk, create, mutate, and validate
 </p>
   <p align="center">
-    <a href="https://www.speakeasy.com/openapi/arazzo"><img src="https://custom-icon-badges.demolab.com/badge/-Arazzo%20Reference-212015?style=for-the-badge&logoColor=FBE331&logo=speakeasy&labelColor=545454" /></a>
-    <a href="https://speakeasy.com/"><img src="https://custom-icon-badges.demolab.com/badge/-Built%20By%20Speakeasy-212015?style=for-the-badge&logoColor=FBE331&logo=speakeasy&labelColor=545454" /></a>
+    <!-- Arazzo Reference badge -->
+     <a href="https://www.speakeasy.com/openapi/arazzo"><img alt="Arazzo reference" src="https://www.speakeasy.com/assets/badges/arazzo-reference.svg" /></a>
+     <!-- Built By Speakeasy Badge -->
+     <a href="https://speakeasy.com/"><img alt="Built by Speakeasy" src="https://www.speakeasy.com/assets/badges/built-by-speakeasy.svg" /></a>
     <a href="https://github.com/speakeasy-api/openapi/releases/latest"><img alt="Release" src="https://img.shields.io/github/release/speakeasy-api/openapi.svg?style=for-the-badge"></a>
     <a href="https://pkg.go.dev/github.com/speakeasy-api/openapi/arazzo?tab=doc"><img alt="Go Doc" src="https://img.shields.io/badge/godoc-reference-blue.svg?style=for-the-badge"></a>
    <br />

openapi/README.md

@@ -6,8 +6,10 @@
   <p align="center">An API for working with <a href="https://spec.openapis.org/oas/v3.1.1">OpenAPI documents</a> including: read, walk, create, mutate, validate, and upgrade
 </p>
   <p align="center">
-    <a href="https://www.speakeasy.com/openapi"><img src="https://custom-icon-badges.demolab.com/badge/-OpenAPI%20Reference-212015?style=for-the-badge&logoColor=FBE331&logo=speakeasy&labelColor=545454" /></a>
-    <a href="https://speakeasy.com/"><img src="https://custom-icon-badges.demolab.com/badge/-Built%20By%20Speakeasy-212015?style=for-the-badge&logoColor=FBE331&logo=speakeasy&labelColor=545454" /></a>
+       <!-- OpenAPI Hub Badge -->
+    <a href="https://www.speakeasy.com/openapi"><img alt="OpenAPI Hub" src="https://www.speakeasy.com/assets/badges/openapi-hub.svg" /></a>
+   <!-- Built By Speakeasy Badge -->
+    <a href="https://speakeasy.com/"><img alt="Built by Speakeasy" src="https://www.speakeasy.com/assets/badges/built-by-speakeasy.svg" /></a>
     <a href="https://github.com/speakeasy-api/openapi/releases/latest"><img alt="Release" src="https://img.shields.io/github/release/speakeasy-api/openapi.svg?style=for-the-badge"></a>
     <a href="https://pkg.go.dev/github.com/speakeasy-api/openapi/openapi?tab=doc"><img alt="Go Doc" src="https://img.shields.io/badge/godoc-reference-blue.svg?style=for-the-badge"></a>
    <br />
@@ -618,7 +620,7 @@ if err := openapi.Marshal(ctx, doc, buf); err != nil {
 fmt.Printf("Document with components:\n%s", buf.String())
 ```
 
-## Inline all references in a JSON Schema,
+## Inline all references in a JSON Schema
 
 creating a self-contained schema that doesn't depend on external definitions.
 
@@ -773,4 +775,4 @@ This repository is maintained by Speakeasy, but we welcome and encourage contrib
 
 All contributions, whether they're bug reports, feature requests, or code changes, help make this project better for everyone.
 
-Please ensure your contributions adhere to our coding standards and include appropriate tests where applicable.
+Please ensure your contributions adhere to our coding standards and include appropriate tests where applicable.

openapi/openapi_examples_test.go

@@ -738,7 +738,7 @@ func Example_workingWithComponents() {
 	//         type: integer
 }
 
-// Example_inliningSchema demonstrates how to inline all references in a JSON Schema,
+// Example_inliningSchema demonstrates how to inline all references in a JSON Schema
 // creating a self-contained schema that doesn't depend on external definitions.
 func Example_inliningSchema() {
 	ctx := context.Background()

overlay/README.md

@@ -6,7 +6,10 @@
   <p align="center">An implementation of the <a href="https://github.com/OAI/Overlay-Specification/blob/3f398c6/versions/1.0.0.md">OpenAPI Overlay Specification</a> for applying modifications to OpenAPI documents
 </p>
   <p align="center">
-    <a href="https://speakeasy.com/openapi/overlays"><img src="https://custom-icon-badges.demolab.com/badge/-Overlay%20Reference-212015?style=for-the-badge&logoColor=FBE331&logo=speakeasy&labelColor=545454" /></a>
+    <!-- Overlay Reference badge -->
+    <a href="https://speakeasy.com/openapi/overlays"><img alt="Overlay reference" src="https://www.speakeasy.com/assets/badges/overlay-reference.svg" /></a>
+    <!-- Built By Speakeasy Badge -->
+    <a href="https://speakeasy.com/"><img alt="Built by Speakeasy" src="https://www.speakeasy.com/assets/badges/built-by-speakeasy.svg" /></a>
     <a href="https://github.com/speakeasy-api/openapi/releases/latest"><img alt="Release" src="https://img.shields.io/github/release/speakeasy-api/openapi.svg?style=for-the-badge"></a>
     <a href="https://pkg.go.dev/github.com/speakeasy-api/openapi-overlay?tab=doc"><img alt="Go Doc" src="https://img.shields.io/badge/godoc-reference-blue.svg?style=for-the-badge"></a>
    <br />