chore(docs): update README

Author: leggetter

README.md

@@ -1,17 +1,20 @@
 # Hookdeck OpenAPI Schema
 
-In addition to the standard uses of OpenAPI schema, the Hookdeck OpenAPI schema is used to generate our SDKS:
+In addition to the standard uses of OpenAPI schema, the Hookdeck OpenAPI schema is used to generate our SDKS using [Fern](https://www.buildwithfern.com/?ref=hookdeck):
 
 - [Go SDK](https://github.com/hookdeck/hookdeck-go-sdk)
 - [TypeScript SDK](https://github.com/hookdeck/hookdeck-typescript-sdk)
-- _More SDKs to come..._
 
 ## What is in this repository?
 
 This repository contains
 
-- Hookdeck's Fern API Definition which lives in the [OpenApi](./fern/openapi/) folder
-- Generators (see [generators.yml](./fern/generators.yml))
+- Hookdeck's API Definition which lives in the root directory and contains some Fern specific extensions
+- Generators used to generate the SDK (see [generators.yml](./fern/generators.yml))
+
+## About Fern
+
+Fern is used to generate our SDKs from the OpenAPI specification.
 
 In order to make sure that the definition is valid, you can use the Fern CLI.
 
@@ -20,27 +23,27 @@ npm install -g fern-api # Installs CLI
 fern check # Checks if the definition is valid
 ```
 
-## What are Generators?
+### What are Generators?
 
 Generators read in your API Definition and output files or code (i.e. the TypeScript SDK Generator) and are tracked in [generators.yml](./fern/generators.yml).
 
-### Local preview
+#### Local preview
 
 You can preview the generated code in the `./local/go/generated/hookdeck-go-sdk` directory by running the following command:
 
 ```sh
 fern generate --group local
 ```
 
-## Validating your API Definition
+### Validating your API Definition
 
 To validate your API, run: 
 ```sh
 npm install -g fern-api # only required once
 fern check
 ```
 
-## Updating your SDKs
+### Updating your SDKs
 
 To update your SDKs, run `fern generate`.