Skip to content

Commit

Permalink
Merge pull request #248 from hey-api/chore/update-docs-more
Browse files Browse the repository at this point in the history
chore: update docs more
  • Loading branch information
jordanshatford authored Apr 4, 2024
2 parents f7a4a44 + dfd21c5 commit af70a4a
Show file tree
Hide file tree
Showing 4 changed files with 12 additions and 5 deletions.
4 changes: 4 additions & 0 deletions docs/.vitepress/config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,12 @@ import { defineConfig } from 'vitepress'
export default defineConfig({
title: "OpenAPI TypeScript",
description: "Turn your OpenAPI specification into a beautiful TypeScript client",
head: [
['link', { rel: 'icon', type: 'image/png', href: '/wave.png' }],
],
themeConfig: {
// https://vitepress.dev/reference/default-theme-config
logo: '/wave.png',
nav: [
{ text: 'Guide', link: '/introduction' },
],
Expand Down
10 changes: 5 additions & 5 deletions docs/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ export default {

Alternatively, you can use `openapi-ts.config.js` and configure the export statement depending on your project setup.

### Clients
## Clients

By default, `openapi-ts` will try to guess your client based on your project dependencies. If we don't get it right, you can specify the desired client

Expand Down Expand Up @@ -68,7 +68,7 @@ We also support the legacy Node.js and XHR clients:
You might not need a `node` client. Fetch API is [experimental](https://nodejs.org/docs/latest-v18.x/api/globals.html#fetch) in Node.js v18 and [stable](https://nodejs.org/docs/latest-v21.x/api/globals.html#fetch) in Node.js v21. We recommend upgrading to the latest Node.js version.
:::

### Formatting
## Formatting

By default, `openapi-ts` will automatically format your client according to your project configuration. To disable automatic formatting, set `format` to false

Expand All @@ -83,7 +83,7 @@ export default {

You can also prevent your client from being processed by formatters by adding your output path to the tool's ignore file (e.g. `.prettierignore`).

### Linting
## Linting

For performance reasons, `openapi-ts` does not automatically lint your client. To enable this feature, set `lint` to true

Expand All @@ -98,7 +98,7 @@ export default {

You can also prevent your client from being processed by linters by adding your output path to the tool's ignore file (e.g. `.eslintignore`).

### Enums
## Enums

If you need to iterate through possible field values without manually typing arrays, you can export enums with

Expand Down Expand Up @@ -131,6 +131,6 @@ export default {
}
```

### Config API
## Config API

You can view the complete list of options in the [UserConfig](https://github.com/hey-api/openapi-ts/blob/main/packages/openapi-ts/src/types/config.ts) interface.
3 changes: 3 additions & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,9 @@ hero:
- theme: alt
text: View on GitHub
link: https://github.com/hey-api/openapi-ts
image:
src: /wave.png
alt: wave

features:
- title: Full Support
Expand Down
Binary file added docs/public/wave.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit af70a4a

Please sign in to comment.