add a little complexity

Makefile

@@ -1,4 +1,8 @@
-.PHONY: *
+.PHONY: all docs
+all: speakeasy docs
 
 speakeasy:
 	speakeasy generate sdk --lang terraform -o . -s hashicups.yaml
+
+docs:
+	go generate ./...

README.md

@@ -7,12 +7,6 @@ It works by using the [Speakeasy](https://speakeasyapi.dev) platform and associa
 This provider is for demonstration purposes only. Do not publish this to the terraform registry.
 
 <!-- Start SDK Installation -->
-## Notice of Alpha Status
-
-This is a Alpha release of the hashicups Terraform Provider.
-
-It is under active development and you may experience breaking changes. Please pin to a version if trialing in production.
-
 ## SDK Installation
 
 To install this provider, copy and paste this code into your Terraform configuration. Then, run `terraform init`.
@@ -21,7 +15,7 @@ To install this provider, copy and paste this code into your Terraform configura
 terraform {
   required_providers {
     hashicups = {
-      source  = "hashicorp/hashicups"
+      source  = "speakeasy/hashicups"
       version = "0.0.1"
     }
   }

docs/index.md

@@ -1,16 +1,31 @@
 ---
 # generated by https://github.com/hashicorp/terraform-plugin-docs
-page_title: "hashicups Provider"
+page_title: "hashicups-speakeasy Provider"
 subcategory: ""
 description: |-
-  
+  Hashicups: Example Hashicups through Speakeasy
 ---
 
-# hashicups Provider
+# hashicups-speakeasy Provider
 
+Hashicups: Example Hashicups through Speakeasy
 
+## Example Usage
 
+```terraform
+terraform {
+  required_providers {
+    hashicups = {
+      source  = "speakeasy/hashicups"
+      version = "0.0.1"
+    }
+  }
+}
 
+provider "hashicups" {
+  # Configuration options
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/resources/hashicups_order.md

@@ -0,0 +1,40 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "hashicups_order Resource - terraform-provider-hashicups-speakeasy"
+subcategory: ""
+description: |-
+  Order Resource
+---
+
+# hashicups_order (Resource)
+
+Order Resource
+
+## Example Usage
+
+```terraform
+resource "hashicups_order" "my_order" {
+  description = "...my_description..."
+  image       = "...my_image..."
+  name        = "Terrence Rau"
+  price       = 85.8
+  teaser      = "...my_teaser..."
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `description` (String) Product description of the coffee.
+- `image` (String) URI for an image of the coffee.
+- `name` (String) Product name of the coffee.
+- `price` (Number) Suggested cost of the coffee.
+- `teaser` (String) Fun tagline for the coffee.
+
+### Read-Only
+
+- `id` (Number) Order ID
+
+

examples/provider/provider.tf

@@ -0,0 +1,12 @@
+terraform {
+  required_providers {
+    hashicups = {
+      source  = "speakeasy/hashicups"
+      version = "0.0.1"
+    }
+  }
+}
+
+provider "hashicups" {
+  # Configuration options
+}

examples/resources/hashicups_order/resource.tf

@@ -0,0 +1,7 @@
+resource "hashicups_order" "my_order" {
+  description = "...my_description..."
+  image       = "...my_image..."
+  name        = "Terrence Rau"
+  price       = 85.8
+  teaser      = "...my_teaser..."
+}

files.gen

@@ -51,8 +51,11 @@ internal/sdk/pkg/models/operations/deleteorder.go
 internal/sdk/pkg/models/operations/getorder.go
 internal/sdk/pkg/models/operations/upsertorder.go
 internal/sdk/pkg/models/shared/order.go
+internal/sdk/pkg/models/shared/createorderinput.go
 internal/sdk/pkg/models/shared/security.go
 USAGE.md
 internal/provider/provider.go
+examples/provider/provider.tf
 internal/provider/order_resource.go
-internal/provider/order_resource_sdk.go
+internal/provider/order_resource_sdk.go
+examples/resources/hashicups_order/resource.tf

gen.yaml

@@ -6,5 +6,5 @@ generation:
   telemetryEnabled: false
 terraform:
   version: 0.0.1
-  author: hashicorp
+  author: speakeasy
   packageName: hashicups

hashicups.yaml

@@ -24,7 +24,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/Order"
+              $ref: "#/components/schemas/CreateOrderInput"
         required: true
       responses:
         "200":
@@ -76,16 +76,42 @@ paths:
         - Order
 components:
   schemas:
+    CreateOrderInput:
+      description: An input object to creating an order
+      x-speakeasy-entity: Order
+      properties:
+        name:
+          type: string
+          description: Product name of the coffee.
+        teaser:
+          type: string
+          description: Fun tagline for the coffee.
+        description:
+          type: string
+          description: Product description of the coffee.
+        price:
+          type: number
+          description: Suggested cost of the coffee.
+        image:
+          type: string
+          description: URI for an image of the coffee.
+      required:
+        - name
+        - teaser
+        - description
+        - price
+        - image
+      type: object
     Order:
       description: An order helps you make coffee
       x-speakeasy-entity: Order
       properties:
-        id:
-          type: integer
-          description: Numeric identifier of the order.
         name:
           type: string
           description: Product name of the coffee.
+        id:
+          type: integer
+          description: Order ID
         teaser:
           type: string
           description: Fun tagline for the coffee.
@@ -99,6 +125,7 @@ components:
           type: string
           description: URI for an image of the coffee.
       required:
+        - id
         - name
         - teaser
         - description