rename file: to title:

Author: davemooreuws

docs/apis.mdx

@@ -714,7 +714,7 @@ By default APIs deployed by Nitric will be assigned a domain by the target cloud
 
 <TabItem label="AWS">
 
-```yaml file:nitric.prod.yaml
+```yaml title:nitric.prod.yaml
 provider: nitric/[email protected]
 region: ap-southeast-2
 
@@ -731,15 +731,15 @@ apis:
 
 <TabItem label="Azure">
 
-```yaml file:nitric.prod.yaml
+```yaml title:nitric.prod.yaml
 # currently unsupported - request support here: https://github.com/nitrictech/nitric/issues
 ```
 
 </TabItem>
 
 <TabItem label="Google Cloud">
 
-```yaml file:nitric.prod.yaml
+```yaml title:nitric.prod.yaml
 # currently unsupported - request support here: https://github.com/nitrictech/nitric/issues
 ```
 
@@ -755,7 +755,7 @@ By default, APIs will not be deployed with a description. You can add a descript
 
 <TabItem label="AWS">
 
-```yaml file:nitric.prod.yaml
+```yaml title:nitric.prod.yaml
 provider: nitric/[email protected]
 region: ap-southeast-2
 
@@ -771,7 +771,7 @@ apis:
 
 <TabItem label="Azure">
 
-```yaml file:nitric.prod.yaml
+```yaml title:nitric.prod.yaml
 provider: nitric/[email protected]
 region: Australia East
 org: example-org
@@ -788,7 +788,7 @@ apis:
 
 <TabItem label="Google Cloud">
 
-```yaml file:nitric.prod.yaml
+```yaml title:nitric.prod.yaml
 provider: nitric/[email protected]
 region: australia-southeast1
 
@@ -857,7 +857,7 @@ Since resource names are unique across each Nitric project, you can access a res
 
 <CodeSwitcher>
 
-```javascript !! file:services/one.js
+```javascript !! title:services/one.js
 import { api } from '@nitric/sdk'
 
 const accountsApi = api('accounts')
@@ -867,7 +867,7 @@ accountsApi.get('/users/:id', async () => {
 })
 ```
 
-```python !! file:services/one.py
+```python !! title:services/one.py
 from nitric.application import Nitric
 from nitric.context import HttpContext
 from nitric.resources import api
@@ -881,7 +881,7 @@ async def get_user(ctx: HttpContext):
 Nitric.run()
 ```
 
-```go !! file:services/one/main.go
+```go !! title:services/one/main.go
 import (
   "github.com/nitrictech/go-sdk/nitric"
   "github.com/nitrictech/go-sdk/nitric/apis"
@@ -898,7 +898,7 @@ func main() {
 }
 ```
 
-```dart !! file:services/one.dart
+```dart !! title:services/one.dart
 import 'package:nitric_sdk/nitric.dart';
 
 final accountsApi = Nitric.api("accounts");
@@ -912,7 +912,7 @@ galaxyApi.get("/users/:id", (ctx) async {
 
 <CodeSwitcher>
 
-```javascript !! file:services/two.js
+```javascript !! title:services/two.js
 import { api } from '@nitric/sdk'
 
 const accountsApi = api('accounts')
@@ -922,7 +922,7 @@ accountsApi.get('/orgs/:id', async () => {
 })
 ```
 
-```python !! file:services/two.py
+```python !! title:services/two.py
 from nitric.application import Nitric
 from nitric.context import HttpContext
 from nitric.resources import api
@@ -936,7 +936,7 @@ async def get_org(ctx: HttpContext):
 Nitric.run()
 ```
 
-```go !! file:services/two/main.go
+```go !! title:services/two/main.go
 import (
   "github.com/nitrictech/go-sdk/nitric"
   "github.com/nitrictech/go-sdk/nitric/apis"
@@ -953,7 +953,7 @@ func main() {
 }
 ```
 
-```dart !! file:services/two.dart
+```dart !! title:services/two.dart
 import 'package:nitric_sdk/nitric.dart';
 
 final accountsApi = Nitric.api("accounts");
@@ -978,19 +978,19 @@ Here is the same example enhanced to import a common API resource.
 
 <CodeSwitcher>
 
-```javascript !! file:resources/index.js
+```javascript !! title:resources/index.js
 import { api } from '@nitric/sdk'
 
 export const accountsApi = api('accounts')
 ```
 
-```python !! file:common/resources.py
+```python !! title:common/resources.py
 from nitric.resources import api
 
 accounts_api = api('accounts')
 ```
 
-```go !! file:resources/main.go
+```go !! title:resources/main.go
 import (
   "github.com/nitrictech/go-sdk/nitric"
   "github.com/nitrictech/go-sdk/nitric/apis"
@@ -1004,7 +1004,7 @@ func init() {
 }
 ```
 
-```dart !! file:common/resources.dart
+```dart !! title:common/resources.dart
 import 'package:nitric_sdk/nitric.dart';
 
 final accountsApi = Nitric.api("accounts");
@@ -1014,15 +1014,15 @@ final accountsApi = Nitric.api("accounts");
 
 <CodeSwitcher>
 
-```javascript !! file:services/one.js
+```javascript !! title:services/one.js
 import { accountsApi } from '../resources'
 
 accountsApi.get('/users/:id', async () => {
   // your logic here
 })
 ```
 
-```python !! file:services/one.py
+```python !! title:services/one.py
 from nitric.application import Nitric
 from nitric.context import HttpContext
 from common.resources import accounts_api
@@ -1035,7 +1035,7 @@ async def get_user(ctx: HttpContext):
 Nitric.run()
 ```
 
-```go !! file:services/one/main.go
+```go !! title:services/one/main.go
 package main
 
 import (
@@ -1054,7 +1054,7 @@ func main() {
 }
 ```
 
-```dart !! file:services/one.dart
+```dart !! title:services/one.dart
 import '../resources';
 
 accountsApi.get("/users/:id", (ctx) async {
@@ -1066,15 +1066,15 @@ accountsApi.get("/users/:id", (ctx) async {
 
 <CodeSwitcher>
 
-```javascript !! file:services/two.js
+```javascript !! title:services/two.js
 import { accountsApi } from '../resources'
 
 accountsApi.get('/orgs/:id', async () => {
   // your logic here
 })
 ```
 
-```python !! file:services/two.py
+```python !! title:services/two.py
 from nitric.application import Nitric
 from nitric.context import HttpContext
 from common.resources import accounts_api
@@ -1087,7 +1087,7 @@ async def get_org(ctx: HttpContext):
 Nitric.run()
 ```
 
-```go !! file:services/two/main.go
+```go !! title:services/two/main.go
 package main
 
 import (
@@ -1106,7 +1106,7 @@ func main() {
 }
 ```
 
-```dart !! file:services/two.dart
+```dart !! title:services/two.dart
 import '../resources';
 
 accountsApi.get("/orgs/:id", (ctx) async {

docs/further-reading/comparison/ampt.mdx

@@ -23,7 +23,7 @@ To get a deeper understanding of the differences, let's see the same app built i
 
 **Nitric**
 
-```typescript file:hello.ts
+```typescript title:hello.ts
 import { api } from '@nitric/sdk'
 
 const helloApi = api('main')
@@ -41,7 +41,7 @@ helloApi.get('/hello/:name', async (ctx) => {
 
 **Ampt (Experimental)**
 
-```typescript file:hello.ts
+```typescript title:hello.ts
 import { api } from '@ampt/api'
 
 const helloApi = api('main').router('/hello')

docs/further-reading/comparison/aws-cdk.mdx

@@ -24,7 +24,7 @@ To get a deeper understanding of the differences, let's see the same app built i
 
 **Nitric**
 
-```typescript file:hello.ts
+```typescript title:hello.ts
 import { api } from '@nitric/sdk'
 
 const helloApi = api('main')
@@ -42,7 +42,7 @@ helloApi.get('/hello/:name', async (ctx) => {
 
 **AWS CDK**
 
-```javascript file:src/index.js
+```javascript title:src/index.js
 exports.handler = async function (event = {}) {
   const name = event.pathParameters.name
 
@@ -53,7 +53,7 @@ exports.handler = async function (event = {}) {
 }
 ```
 
-```typescript file:lib/hello-stack.ts
+```typescript title:lib/hello-stack.ts
 import * as cdk from 'aws-cdk-lib'
 import { Construct } from 'constructs'
 import * as apigateway from 'aws-cdk-lib/aws-apigateway'

docs/further-reading/comparison/encore.mdx

@@ -23,7 +23,7 @@ To get a deeper understanding of the differences, let's see the same app built i
 
 **Nitric**
 
-```go file:services/hello/main.go
+```go title:services/hello/main.go
 package main
 
 import (
@@ -50,7 +50,7 @@ func main() {
 
 **Encore**
 
-```go file:hello.go
+```go title:hello.go
 package hello
 
 import (

docs/further-reading/comparison/pulumi.mdx

@@ -34,7 +34,7 @@ To showcase the power of the abstraction provided by Nitric here is a showcase o
 
 **Nitric**
 
-```javascript file:handle.js
+```javascript title:handle.js
 import * as nitric from '@nitric/sdk'
 
 const bucket = nitric.bucket('my-bucket').allow('read', 'write')
@@ -50,7 +50,7 @@ bucket.on('create', '*', async (ctx) => {
 
 **Pulumi**
 
-```javascript file:src/index.js
+```javascript title:src/index.js
 const AWS = require('aws-sdk')
 
 exports.handler = async (event) => {
@@ -61,7 +61,7 @@ exports.handler = async (event) => {
 }
 ```
 
-```javascript file:lib/handle-stack.js
+```javascript title:lib/handle-stack.js
 import * as pulumi from '@pulumi/pulumi'
 import * as aws from '@pulumi/aws'
 import * as fs from 'fs'

docs/further-reading/comparison/sst.mdx

@@ -24,7 +24,7 @@ To get a deeper understanding of the differences, let's see the same app built i
 
 **Nitric**
 
-```javascript file:hello.js
+```javascript title:hello.js
 import { api } from '@nitric/sdk'
 
 const helloApi = api('main')
@@ -42,7 +42,7 @@ helloApi.get('/hello/:name', async (ctx) => {
 
 **SST**
 
-```javascript file:packages/functions/hello.ts
+```javascript title:packages/functions/hello.ts
 import { ApiHandler, usePathParam } from 'sst/node/api'
 
 export const handler = ApiHandler(async (evt) => {
@@ -55,7 +55,7 @@ export const handler = ApiHandler(async (evt) => {
 })
 ```
 
-```javascript file: stacks/hello-stack.ts
+```javascript title: stacks/hello-stack.ts
 import { StackContext, Api } from 'sst/constructs'
 
 export function API({ stack }: StackContext) {

docs/further-reading/comparison/terraform.mdx

@@ -32,7 +32,7 @@ To showcase the power of the abstraction provided by Nitric here is a showcase o
 
 **Nitric**
 
-```javascript file:handle.js
+```javascript title:handle.js
 import * as nitric from '@nitric/sdk'
 
 const bucket = nitric.bucket('my-bucket').allow('read', 'write')
@@ -48,7 +48,7 @@ bucket.on('create', '*', async (ctx) => {
 
 **Terraform**
 
-```javascript file:src/index.js
+```javascript title:src/index.js
 const AWS = require('aws-sdk')
 
 exports.handler = async (event) => {
@@ -59,7 +59,7 @@ exports.handler = async (event) => {
 }
 ```
 
-```hcl file:main.tf
+```hcl title:main.tf
 terraform {
   required_providers {
     aws = {

docs/further-reading/comparison/winglang.mdx

@@ -20,7 +20,7 @@ Both options are extremely productive, it's up to you which approach you prefer.
 
 **Nitric**
 
-```javascript file:hello.js
+```javascript title:hello.js
 import { api } from '@nitric/sdk'
 
 const helloApi = api('far-away-galaxy-api')