Skip to content

Commit 627adf9

Browse files
committed
Copyedit customization pages
1 parent 10cfd1e commit 627adf9

File tree

3 files changed

+11
-12
lines changed

3 files changed

+11
-12
lines changed

api-playground/customization/adding-sdk-examples.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Adding SDK examples"
33
description: "Display language-specific code samples alongside your API endpoints to show developers how to use your SDKs"
44
---
55

6-
If your users interact with your API using an SDK rather than directly through a network request, you can use the `x-codeSamples` extension to add code samples to your OpenAPI document and Mintlify will display them in your OpenAPI pages.
6+
If your users interact with your API using an SDK rather than directly through a network request, you can use the `x-codeSamples` extension to add code samples to your OpenAPI document and display them in your OpenAPI pages.
77

88
This property can be added to any request method and has the following schema.
99

@@ -19,7 +19,7 @@ This property can be added to any request method and has the following schema.
1919
The source code of the sample.
2020
</ParamField>
2121

22-
Here is an example of some code samples for a plant tracking app, which has both a Bash CLI tool and a JavaScript SDK.
22+
Here is an example of code samples for a plant tracking app, which has both a Bash CLI tool and a JavaScript SDK.
2323

2424
```yaml
2525
paths:

api-playground/customization/complex-data-types.mdx

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,25 +3,25 @@ title: "Complex data types"
33
description: "Describe APIs with flexible schemas, optional properties, and multiple data formats using `oneOf`, `anyOf`, and `allOf` keywords"
44
---
55

6-
When your API accepts multiple data formats, has conditional fields, or uses inheritance patterns, OpenAPI's schema composition keywords help you document these flexible structures clearly. Using `oneOf`, `anyOf`, and `allOf`, you can describe APIs that handle different input types or combine multiple schemas into comprehensive data models.
6+
When your API accepts multiple data formats, has conditional fields, or uses inheritance patterns, OpenAPI's schema composition keywords help you document these flexible structures. Using `oneOf`, `anyOf`, and `allOf`, you can describe APIs that handle different input types or combine multiple schemas into comprehensive data models.
77

88
## `oneOf`, `anyOf`, `allOf` keywords
99

1010
For complex data types, OpenAPI provides keywords for combining schemas:
1111

12-
- `allOf`: Combines multiple schemas (like merging objects or extending a base schema). Functions like an *and* operator.
13-
- `anyOf`: Accepts data matching any of the provided schemas. Functions like an *or* operator.
14-
- `oneOf`: Accepts data matching exactly one of the provided schemas. Functions like an *exclusive-or* operator.
12+
- `allOf`: Combines multiple schemas (like merging objects or extending a base schema). Functions like an `and` operator.
13+
- `anyOf`: Accepts data matching any of the provided schemas. Functions like an `or` operator.
14+
- `oneOf`: Accepts data matching exactly one of the provided schemas. Functions like an `exclusive-or` operator.
1515

16-
<Warning>Mintlify treats `oneOf` and `anyOf` identically. Most APIs work fine with `anyOf` since the practical difference is rarely important to users.</Warning>
16+
<Warning>Mintlify treats `oneOf` and `anyOf` identically since the practical difference rarely affects using the API.</Warning>
1717

1818
For detailed specifications of these keywords see the [OpenAPI documentation](https://swagger.io/docs/specification/data-models/oneof-anyof-allof-not/).
1919

20-
<Info>The `not` keyword is not currently supported.</Info>
20+
<Info>The `not` keyword is currently unsupported.</Info>
2121

2222
### Combining schemas with `allOf`
2323

24-
When you use `allOf`, Mintlify performs some preprocessing on your OpenAPI document to display complex combinations in a readable way. For example, when you combine two object schemas with `allOf`, Mintlify combines the properties of both into a single object. This becomes especially useful when leveraging OpenAPI's [reusable `components`](https://swagger.io/docs/specification/components/).
24+
When you use `allOf`, Mintlify performs some preprocessing on your OpenAPI document to display complex combinations in a readable way. For example, when you combine two object schemas with `allOf`, Mintlify combines the properties of both into a single object. This becomes especially useful when leveraging OpenAPI's reusable [`components`](https://swagger.io/docs/specification/components/).
2525

2626
```yaml
2727
org_with_users:

api-playground/customization/managing-page-visibility.mdx

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,9 @@ title: "Managing page visibility"
33
description: "Control which endpoints from your OpenAPI specification appear in your documentation navigation"
44
---
55

6+
You can control which OpenAPI operations get published as documentation pages and their visibility in navigation. This is useful for internal-only endpoints, deprecated operations, beta features, or endpoints that should be accessible via direct URL but not discoverable through site navigation.
67

7-
You can control exactly which parts of your OpenAPI specification get published and how they're organized. Hiding pages can be useful when you're documenting internal APIs, beta features, or other endpoints that shouldn't appear in navigation.
8-
9-
If your pages are autogenerated from an OpenAPI document, you can control which endpoints get published and how they appear in your documentation with the `x-hidden` and `x-excluded` extensions.
8+
If your pages are autogenerated from an OpenAPI document, you can manage page visibility with the `x-hidden` and `x-excluded` extensions.
109

1110
## `x-hidden`
1211

0 commit comments

Comments
 (0)