Skip to content

Commit ecdaa49

Browse files
Update FAQ script to include note on correctness of spelling mistake (#654)
1 parent fa0d335 commit ecdaa49

8 files changed

+11
-10
lines changed

Sources/swift-openapi-generator/Documentation.docc/Articles/Frequently-asked-questions.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,13 +16,13 @@ This article includes some commonly asked questions and answers.
1616

1717
Check out <doc:Project-scope-and-goals>.
1818

19-
### What OpenAPI featues does the generator support?
19+
### What OpenAPI features does the generator support?
2020

2121
Check out <doc:Supported-OpenAPI-features>.
2222

2323
### Which underlying HTTP library does the generated code use?
2424

25-
Swift OpenAPI Generator is not tied to any particular HTTP library. Instead, the generated code utilizies a general protocol called [`ClientTransport`](https://swiftpackageindex.com/apple/swift-openapi-runtime/documentation/openapiruntime/clienttransport) for client code, and [`ServerTransport`](https://swiftpackageindex.com/apple/swift-openapi-runtime/documentation/openapiruntime/servertransport) for server code.
25+
Swift OpenAPI Generator is not tied to any particular HTTP library. Instead, the generated code utilizes a general protocol called [`ClientTransport`](https://swiftpackageindex.com/apple/swift-openapi-runtime/documentation/openapiruntime/clienttransport) for client code, and [`ServerTransport`](https://swiftpackageindex.com/apple/swift-openapi-runtime/documentation/openapiruntime/servertransport) for server code.
2626

2727
The user of the generated code provides one of the concrete transport implementations, based on what's appropriate for their use case.
2828

@@ -87,6 +87,7 @@ In Xcode Cloud, add the script `ci_scripts/ci_post_clone.sh` next to your Xcode
8787

8888
set -e
8989

90+
# NOTE: the misspelling of validation as "validatation" is intentional and the spelling Xcode expects.
9091
defaults write com.apple.dt.Xcode IDESkipPackagePluginFingerprintValidatation -bool YES
9192
```
9293

Sources/swift-openapi-generator/Documentation.docc/Articles/Practicing-spec-driven-API-development.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -113,7 +113,7 @@ Publishing the source of truth is preferable to relying on transcoding from code
113113

114114
By inferring the specification from existing code, the resulting OpenAPI spec is often lossy and incomplete. And even with annotated code, it can be difficult to predict the OpenAPI output.
115115

116-
Additionally, any feature unsupported by the transcoder cannot be represented in the generated OpenAPI document, further limiting the creativity and expressivness of the API.
116+
Additionally, any feature unsupported by the transcoder cannot be represented in the generated OpenAPI document, further limiting the creativity and expressiveness of the API.
117117

118118
> Tip: Publish the source of truth, not a representation transcoded from the source of truth.
119119

Sources/swift-openapi-generator/Documentation.docc/Tutorials/Adding-openapi-and-swagger-ui-endpoints.tutorial

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
@Intro(title: "Adding OpenAPI and Swagger UI endpoints") {
33
One of the most popular ways to share your OpenAPI document with your users is to host it alongside your API server itself.
44

5-
Typically this is at `/openapi.yaml` or similar, which serves a plain-text OpenAPI document for consumpion by clients.
5+
Typically this is at `/openapi.yaml` or similar, which serves a plain-text OpenAPI document for consumption by clients.
66

77
Additionally, you can host an HTML page that renders the OpenAPI document as interactive documentation that you can use from the browser, for example using [swagger-ui](https://github.com/swagger-api/swagger-ui).
88

@@ -37,7 +37,7 @@
3737
This step is necessary because the Vapor middleware serves files relative to the current working directory for the running server process.
3838
}
3939
@Step {
40-
Test this enpoint in your browser, or using curl.
40+
Test this endpoint in your browser, or using curl.
4141

4242
@Code(name: "console", file: server-openapi-endpoints.console.2.txt, previousFile: server-openapi-endpoints.console.1.txt)
4343
}

Sources/swift-openapi-generator/Documentation.docc/Tutorials/_Resources/server-openapi-endpoints.main.0.swift

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ let app = Vapor.Application()
2121
let transport = VaporTransport(routesBuilder: app)
2222

2323
// Create an instance of your handler type that conforms the generated protocol
24-
// defininig your service API.
24+
// defining your service API.
2525
let handler = GreetingServiceAPIImpl()
2626

2727
// Call the generated function on your implementation to add its request

Sources/swift-openapi-generator/Documentation.docc/Tutorials/_Resources/server-openapi-endpoints.main.1.swift

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ let app = Vapor.Application()
2121
let transport = VaporTransport(routesBuilder: app)
2222

2323
// Create an instance of your handler type that conforms the generated protocol
24-
// defininig your service API.
24+
// defining your service API.
2525
let handler = GreetingServiceAPIImpl()
2626

2727
// Call the generated function on your implementation to add its request

Sources/swift-openapi-generator/Documentation.docc/Tutorials/_Resources/server-openapi-endpoints.main.2.swift

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ let app = Vapor.Application()
2121
let transport = VaporTransport(routesBuilder: app)
2222

2323
// Create an instance of your handler type that conforms the generated protocol
24-
// defininig your service API.
24+
// defining your service API.
2525
let handler = GreetingServiceAPIImpl()
2626

2727
// Call the generated function on your implementation to add its request

Sources/swift-openapi-generator/Documentation.docc/Tutorials/_Resources/server.main.1.2.swift

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ let app = Vapor.Application()
2121
let transport = VaporTransport(routesBuilder: app)
2222

2323
// Create an instance of your handler type that conforms the generated protocol
24-
// defininig your service API.
24+
// defining your service API.
2525
let handler = GreetingServiceAPIImpl()
2626

2727
// Call the generated function on your implementation to add its request

Sources/swift-openapi-generator/Documentation.docc/Tutorials/_Resources/server.main.2.swift

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ let app = Vapor.Application()
2929
let transport = VaporTransport(routesBuilder: app)
3030

3131
// Create an instance of your handler type that conforms the generated protocol
32-
// defininig your service API.
32+
// defining your service API.
3333
let handler = GreetingServiceAPIImpl()
3434

3535
// Call the generated function on your implementation to add its request

0 commit comments

Comments
 (0)