Skip to content

Commit

Permalink
Fix wording in documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
sgayangi committed Nov 11, 2024
1 parent 55afb64 commit 7a7dee3
Show file tree
Hide file tree
Showing 11 changed files with 22 additions and 23 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ To enable the Router access logs, update the `values.yaml`'s `wso2.apk.dp.gatewa
enable: true
```
For the Advance Configuration, you can configure Router access logs by using the following configs. Router access logs related configurations are in the `log_config.toml` file, which is located in ConfigMap file located in the following file in the APK helm chart.
For the advanced configurations, you can configure Router access logs by using the following configs. Router access logs related configurations are in the `log_config.toml` file, which is located in ConfigMap file located in the following file in the APK helm chart.

```yaml
apk/helm-charts/templates/data-plane/gateway-components/log-conf.yaml
Expand Down Expand Up @@ -308,7 +308,7 @@ To enable the wire logs, update the `values.yaml`'s `wso2.apk.dp.gatewayRuntime.
enable: true
```

For the Advance Configurations, configure the wire logs, using the following configuration in the `log_config.toml` file, which is located in ConfigMap file located in the following file in the APK helm chart.
For the advanced configurations, configure the wire logs, using the following configuration in the `log_config.toml` file, which is located in ConfigMap file located in the following file in the APK helm chart.

```yaml
apk/helm-charts/templates/data-plane/gateway-components/log-conf.yaml
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
}
],
"paths": {
"/employee": {
"/employees": {
"get": {
"tags": [
"employee-controller"
Expand Down
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
1. Save and download the sample [StarWarsAPI.graphql](../../../assets/files/get-started/StarWarsAPI.graphql) file. This is the GraphQL SDL of the API that we will be using.
1. Download and save the sample [StarWarsAPI.graphql](../../../assets/files/get-started/StarWarsAPI.graphql) file. This is the GraphQL SDL of the API that we will be using.
2. Login to the Publisher Console [API Publisher](https://am.wso2.com/publisher) of the WSO2 API Manager.
3. Under the GraphQL option, use `Import GraphQL SDL` option.
4. Provide the GraphQL definition of the API that was downloaded in step 1 and click `Next`.
5. Provide the following information.

| Field | Sample value |
|----------|---------------------------------------------|
| Name | StarWarsAPI |
| Context | /starwars |
| Version | 1.0.0 |
| Endpoint | http://graphql-faker-service:9002/graphql |
| Field | Sample value |
| -------- | ----------------------------------------- |
| Name | StarWarsAPI |
| Context | /starwars |
| Version | 1.0.0 |
| Endpoint | http://graphql-faker-service:9002/graphql |

6. Select the APK Gateway and click Create.
7. Navigate to the Deploy section and click Deployments.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ You can use the following sample OpenAPI Specification (OAS) definition for the
- [Azure OpenAI OAS Definition](https://raw.githubusercontent.com/wso2/apk/refs/heads/main/samples/llm-providers-oas-definitions/azure/azure_api.yaml)
- [Mistral AI OAS Definition](https://raw.githubusercontent.com/wso2/apk/refs/heads/main/samples/llm-providers-oas-definitions/mistral/mistral_api.yaml)

Save and download the selected sample file. This is the OAS definition of the AI API that we are going to deploy in APK.
Download and save the selected sample file. This is the OAS definition of the AI API that we are going to deploy in APK.

## Step 2. Obtain the API Key and Endpoint from the LLM Service Provider

Expand Down Expand Up @@ -153,11 +153,11 @@ operations:
The 'ai provider' field should be replaced with the actual AI Provider name and API Version.
Refer the following table for the AI Provider name and API Version.
| AI Provider | API Version |
|--------------------------|-------------|
| AzureAI | 2024-06-01 |
| ai-provider-open-ai | v1 |
| ai-provider-mistral-ai | v1 |
| AI Provider | API Version |
| ---------------------- | ----------- |
| AzureAI | 2024-06-01 |
| ai-provider-open-ai | v1 |
| ai-provider-mistral-ai | v1 |
!!! note
- The `endpoint` and `deployment-id` in the `endpoint` field should be replaced with the actual values provided by the LLM Service Provider.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ kubectl get pods -n <namespace>

Follow the instructions below to design a GraphQL API.

1. Save and download the sample [StarWarsAPI.graphql](../../../assets/files/get-started/StarWarsAPI.graphql) file. This is the GraphQL SDL of the API that we are going to deploy in APK.
1. Download and save the sample [StarWarsAPI.graphql](../../../assets/files/get-started/StarWarsAPI.graphql) file. This is the GraphQL SDL of the API that we are going to deploy in APK.

2. Execute the following request to generate the APK configuration. Use the values provided in the table below in the body of your request.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ If you wish to deploy a GRPC API that has multiple .proto files, you can follow

### Step 1 - Obtain the proto files for the given API

Save and download the following file as Student.proto.
Download and save the following file as Student.proto.

Student API: [Student.proto](https://raw.githubusercontent.com/wso2/docs-apk/refs/heads/1.2.0/en/docs/assets/files/get-started/student.proto)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ The following steps are a quickstart guide on deploying a GRPC API that has mult

### Step 1 - Obtain the proto files for the given API

Save and download the following files.
Download and save the following files.

Order API: [OrderDefinition.zip](../../../assets/files/get-started/OrderDefinition.zip)

Expand Down
2 changes: 1 addition & 1 deletion en/docs/get-started/quick-start-guide-with-cp.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Install the <a href="../../setup/prerequisites" target="_blank">prerequisites</a

## Step 2 - Create and Deploy the API From Dataplane

1. Save and download the sample
1. Download and save the sample
<a href="https://raw.githubusercontent.com/wso2/docs-apk/refs/heads/1.2.0/en/docs/assets/files/get-started/EmployeeServiceDefinition.json"
target="_blank" onclick="downloadFile(event)">EmployeeServiceDefinition.json</a> file. This is the OAS definition of the API that we are going to deploy in APK.
2. Add a hostname mapping to the ```/etc/hosts``` file as follows.
Expand Down
2 changes: 1 addition & 1 deletion en/docs/get-started/quick-start-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ kubectl get pods

## Step 3 - Create and Deploy the API

1. Save and download the sample
1. Download and save the sample
<a href="https://raw.githubusercontent.com/wso2/docs-apk/refs/heads/1.2.0/en/docs/assets/files/get-started/EmployeeServiceDefinition.json"
target="_blank" onclick="downloadFile(event)">EmployeeServiceDefinition.json</a> file. This is the OAS definition of the API that we are going to deploy in APK.
1. Add a hostname mapping to the ```/etc/hosts``` file as follows.
Expand Down
2 changes: 1 addition & 1 deletion en/docs/includes/create-apk-conf-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ kubectl get pods

You will need an OpenAPI Specification 3.x that describes the structure and behavior of your API. This file serves as the foundation for configuring your API and is essential for generating the APK Configuration file.

Save and download the sample [EmployeeServiceDefinition.json](https://raw.githubusercontent.com/wso2/apk/main/developer/tryout/samples/definitions/EmployeeServiceDefinition.json) file. This is the OAS definition of the API that we are going to deploy in APK.
Download and save the sample [EmployeeServiceDefinition.json](https://raw.githubusercontent.com/wso2/apk/main/developer/tryout/samples/definitions/EmployeeServiceDefinition.json) file. This is the OAS definition of the API that we are going to deploy in APK.

## Step 3. Generate APK configuration file.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -62,5 +62,4 @@ By default, WSO2 APK is configured to support the Data Plane Only Pattern. You c

{!control-plane/start-apk-dp-to-cp-vms.md!}


This approach is recommended for all Production, Dev, Test, and UAT environments. Here a seperate kubernetes cluster and a VM server is required for each environment.

0 comments on commit 7a7dee3

Please sign in to comment.