fix go batch docs

Author: jyecusch

src/pages/batch.mdx

@@ -4,10 +4,25 @@ export const description = 'Running AI & Batch workloads with Nitric'
 
 Nitric provides functionality that allows you to run large-scale jobs in parallel across multiple virtual machines or compute resources. Unlike Nitric Services, which respond to real-time events (APIs, Schedules, etc.), Batch is intended to efficiently handle tasks that can be processed in batches, which means they don't need to run in real time but can be executed asynchronously. Batches can include tasks that require a lot of computing power, or access to GPU resources, such as machine learning model training, image processing, video transcoding, data processing, and data analysis.
 
+<Note>
+  Batches are currently in [Preview](/reference/preview-features) and are
+  currently only available in the following languages: JavaScript, Python, Go,
+  and Dart, using the nitric/[email protected], nitric/[email protected] or later.
+</Note>
+
 Nitric Batch is designed to be used in conjunction with Nitric Services, allowing you to run long-running, computationally intensive tasks in parallel with your real-time services. This allows you to build complex applications that can handle both real-time and batch processing workloads.
 
 Batches are deployed to cloud services such as [AWS Batch](https://aws.amazon.com/batch/), [Azure Batch](https://azure.microsoft.com/en-au/products/batch), and [Google Cloud Batch](https://cloud.google.com/batch/docs). Nitric abstracts the underlying cloud provider, allowing you to run your batch jobs on any of the supported cloud providers without having to worry about the specifics of each provider.
 
+## Enabling Batches
+
+Batches are currently in [Preview](/reference/preview-features). To enable this feature in your project add the following to your `nitric.yaml` file
+
+```yaml
+preview:
+  - batch-services
+```
+
 ## Definitions
 
 ### Batch
@@ -42,7 +57,7 @@ Batches are defined similarly to services in a project's `nitric.yaml` file. For
 ```yaml
 batch-services:
   - match: ./batches/*.ts
-    start: yarn dev:batches $SERVICE_PATH
+    start: yarn dev:services $SERVICE_PATH
 ```
 
 <Note>Batches can contain any number of Job Definitions.</Note>
@@ -83,6 +98,24 @@ async def generate_image(ctx: None):
 Nitric.run()
 ```
 
+```go
+import (
+  "github.com/nitrictech/go-sdk/nitric"
+  "github.com/nitrictech/go-sdk/nitric/batch"
+)
+
+func main() {
+  analyze := nitric.NewJob("analyze")
+
+  // Use `Handler` to register the callback function that will run when a job is submitted
+  analyze.Handler(func(ctx *batch.Ctx) {
+    // Do some work
+  }, batch.WithCpus(1), batch.WithMemory(1024), batch.WithGpus(0))
+
+  nitric.Run()
+}
+```
+
 ```dart
 import 'package:nitric_sdk/nitric.dart';
 
@@ -136,6 +169,29 @@ async def submit_job(ctx):
 Nitric.run()
 ```
 
+```go
+import (
+	"context"
+
+	"github.com/nitrictech/go-sdk/nitric"
+	"github.com/nitrictech/go-sdk/nitric/apis"
+	"github.com/nitrictech/go-sdk/nitric/batch"
+)
+
+func main() {
+	api := nitric.NewApi("public")
+	analyze := nitric.NewJob("analyze").Allow(batch.JobSubmit)
+
+	api.Post("/submit-job", func(ctx *apis.Ctx) {
+		analyze.Submit(context.Background(), map[string]interface{}{
+			"someKey": "someValue",
+		})
+	})
+
+	nitric.Run()
+}
+```
+
 ```dart
 import 'package:nitric_sdk/nitric.dart';
 

src/pages/reference/go/batch/job-handler.mdx

@@ -7,26 +7,18 @@ Job handlers are the code that is run when a job request is submitted. These han
 
 ```go
 import (
-	"fmt"
-
 	"github.com/nitrictech/go-sdk/nitric"
 	"github.com/nitrictech/go-sdk/nitric/batch"
 )
 
 func main() {
 	analyze := nitric.NewJob("analyze")
 
-	analyze.Handler(nitric.JobResourceRequirements{
-		Cpus:   1,
-		Memory: 2048,
-		Gpus:   0,
-	}, func(ctx *batch.Ctx) {
+	analyse.Handler(func(ctx *batch.Ctx) {
 		// do long running work
-	})
+	}, batch.WithCpus(1), batch.WithMemory(2048), batch.WithGpus(1))
 
-	if err := nitric.Run(); err != nil {
-		fmt.Println(err)
-	}
+	nitric.Run()
 }
 ```
 
@@ -46,14 +38,14 @@ batch-services:
   <Property name="handler" required type="JobHandler">
     The middleware service to use as the handler for Job requests.
   </Property>
-  <Property name="opts" type="JobResourceRequirements" nested>
-    <Property name="cpus" type="float32">
+  <Property name="options" type="...JobOption" nested>
+    <Property name="WithCpus" type="float32">
       The number of CPUs to allocate to the handler
     </Property>
-    <Property name="gpus" type="int64">
+    <Property name="WithGpus" type="int64">
       The number of GPUs to allocate to the handler
     </Property>
-    <Property name="memory" type="int64">
+    <Property name="WithMemory" type="int64">
       The amount of memory (MB) to allocate to the handler
     </Property>
   </Property>
@@ -65,48 +57,36 @@ batch-services:
 
 ```go
 import (
-	"fmt"
-
 	"github.com/nitrictech/go-sdk/nitric"
 	"github.com/nitrictech/go-sdk/nitric/batch"
 )
 
 func main() {
 	analyze := nitric.NewJob("analyze")
 
-	analyze.Handler(nitric.JobResourceRequirements{}, func(ctx *batch.Ctx) {
+	analyse.Handler(func(ctx *batch.Ctx) {
 		// do long running work
 	})
 
-	if err := nitric.Run(); err != nil {
-		fmt.Println(err)
-	}
+	nitric.Run()
 }
 ```
 
 ### Create a job handler with custom resource requirements
 
 ```go
 import (
-	"fmt"
-
 	"github.com/nitrictech/go-sdk/nitric"
 	"github.com/nitrictech/go-sdk/nitric/batch"
 )
 
 func main() {
 	analyze := nitric.NewJob("analyze")
 
-	analyze.Handler(nitric.JobResourceRequirements{
-		Cpus:   1,
-		Memory: 2048,
-		Gpus:   0,
-	}, func(ctx *batch.Ctx) {
+	analyse.Handler(func(ctx *batch.Ctx) {
 		// do long running work
-	})
+	}, batch.WithCpus(1), batch.WithMemory(2048), batch.WithGpus(1))
 
-	if err := nitric.Run(); err != nil {
-		fmt.Println(err)
-	}
+	nitric.Run()
 }
 ```

src/pages/reference/go/batch/job-submit.mdx

@@ -8,24 +8,19 @@ Jobs may be submitted from Nitric `services` or other `batches` using the `submi
 ```go
 import (
 	"context"
-	"fmt"
 
 	"github.com/nitrictech/go-sdk/nitric"
+	"github.com/nitrictech/go-sdk/nitric/batch"
 )
 
 func main() {
-	analyze, err := nitric.NewJob("analyze").Allow(nitric.JobSubmit)
-	if err != nil {
-		fmt.Println(err)
-	}
+	analyse := nitric.NewJob("analyse").Allow(batch.JobSubmit)
 
 	analyze.Submit(context.TODO(), map[string]interface{}{
 		"message": "message contents",
 	})
 
-	if err := nitric.Run(); err != nil {
-		fmt.Println(err)
-	}
+	nitric.Run()
 }
 ```
 
@@ -44,23 +39,18 @@ func main() {
 ```go
 import (
 	"context"
-	"fmt"
 
 	"github.com/nitrictech/go-sdk/nitric"
+	"github.com/nitrictech/go-sdk/nitric/batch"
 )
 
 func main() {
-	analyze, err := nitric.NewJob("analyze").Allow(nitric.JobSubmit)
-	if err != nil {
-		fmt.Println(err)
-	}
+	analyse := nitric.NewJob("analyse").Allow(batch.JobSubmit)
 
 	analyze.Submit(context.TODO(), map[string]interface{}{
 		"message": "message contents",
 	})
 
-	if err := nitric.Run(); err != nil {
-		fmt.Println(err)
-	}
+	nitric.Run()
 }
 ```

src/pages/reference/go/batch/job.mdx

@@ -7,17 +7,13 @@ Creates a new Batch Job.
 
 ```go
 import (
-	"fmt"
-
 	"github.com/nitrictech/go-sdk/nitric"
 )
 
 func main() {
 	analyze := nitric.NewJob("analyze")
 
-	if err := nitric.Run(); err != nil {
-		fmt.Println(err)
-	}
+	nitric.Run()
 }
 ```
 
@@ -36,37 +32,29 @@ func main() {
 
 ```go
 import (
-	"fmt"
-
 	"github.com/nitrictech/go-sdk/nitric"
 )
 
 func main() {
 	analyze := nitric.NewJob("analyze")
 
-	if err := nitric.Run(); err != nil {
-		fmt.Println(err)
-	}
+	nitric.Run()
 }
 ```
 
 ### Create a Job with permissions to submit jobs
 
 ```go
-import (
-	"fmt"
+package main
 
+import (
 	"github.com/nitrictech/go-sdk/nitric"
+	"github.com/nitrictech/go-sdk/nitric/batch"
 )
 
 func main() {
-	analyze, err := nitric.NewJob("analyze").Allow(nitric.JobSubmit)
-	if err != nil {
-		fmt.Println(err)
-	}
-
-	if err := nitric.Run(); err != nil {
-		fmt.Println(err)
-	}
+	analyse := nitric.NewJob("analyse").Allow(batch.JobSubmit)
+
+	nitric.Run()
 }
 ```

src/pages/reference/preview-features/index.mdx

@@ -15,6 +15,7 @@ Each preview feature will have its own documentation page, which will include in
 | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
 | [docker-providers](/reference/providers/install/docker) | CLI v1.39.0                                                                                     | [feedback](https://github.com/nitrictech/nitric/issues/605) |
 | [sql-databases](/sql)                                   | CLI v1.42.0<br/>AWS Provider v1.6.0<br/>Azure Provider v1.9.0<br/>AWS Terraform Provider v1.8.0 | [feedback](https://github.com/nitrictech/cli/issues/732)    |
+| [batch-services](/batch)                                | CLI v1.54.0<br/>AWS Provider v1.14.0<br/>GCP Provider v1.14.0                                   | [feedback](                                                 |
 
 ## Released Preview Features