Skip to content

Commit 4a225ef

Browse files
Minor phrasing cleanup
Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>
1 parent 698d28a commit 4a225ef

File tree

2 files changed

+11
-6
lines changed

2 files changed

+11
-6
lines changed

app/_how-tos/package-apis-with-dev-portal.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ tldr:
2828
1. Create an API and attach an OpenAPI spec. Operations from your API's OpenAPI spec should overlap with Routes to ensure requests will be routed to the correct Service. Gateway routing configuration isn't directly modified by adding operations.
2929
1. Link a control plane to allow developer consumption.
3030
1. Apply the Access Control Enforcement (ACE) plugin globally.
31-
1. Create an API package by adding operations and package rate limits. Operations are automatically mapped to Routes using your API's OpenAPI spec or you can create them manually. The Gateway configuration isn't directly modified– any unmatched operations will be highlighted to indicate that a user Gateway Manager permissions needs to perform an action.
31+
1. Create an API package by adding operations and package rate limits. Operations are automatically mapped to Routes using your API's OpenAPI spec. The Gateway configuration isn't directly modified– any unmatched operations will be highlighted to indicate that a user needs Gateway Manager permissions needs to perform an action.
3232
prereqs:
3333
inline:
3434
- title: "{{site.konnect_short_name}} roles"
@@ -54,6 +54,7 @@ prereqs:
5454
For this tutorial, you’ll need {{site.base_gateway}} entities, like Gateway Services and Routes, pre-configured. These entities are essential for {{site.base_gateway}} to function but installing them isn’t the focus of this guide.
5555
5656
1. Run the following command:
57+
5758
```yaml
5859
echo '
5960
_format_version: "3.0"
@@ -256,7 +257,7 @@ cleanup:
256257
icon_url: /assets/icons/gateway.svg
257258
---
258259

259-
You can compose API packages from existing APIs in Dev Portal. API packages allow you to:
260+
You can compose [API packages](/dev-portal/api-packaging/) from existing APIs in Dev Portal. API packages allow you to:
260261
* Create distinct APIs for specific use cases or partners based on existing API operations.
261262
* Link to multiple Gateway Services and/or Routes for developer self-service and application registration.
262263
* Apply rate limiting policies to an API Package, or per operation.
@@ -282,7 +283,7 @@ To allow developers to consume your API, you must first link an API Gateway and
282283

283284
## Assign operations to API packages
284285

285-
Now, you can create an API package by picking operations from your API.
286+
Now, you can create an API package by picking operations from your API. Operations are automatically mapped to Routes using your API's OpenAPI spec. The Gateway configuration isn't directly modified– any unmatched operations will be highlighted to indicate that a user needs Gateway Manager permissions needs to perform an action.
286287

287288
1. In the {{site.konnect_short_name}} sidebar, click **Catalog**.
288289
1. Click the **API packages** tab.
@@ -307,7 +308,7 @@ Now, you can create an API package by picking operations from your API.
307308
1. Click the **API packages** tab.
308309
1. Click **Company package**.
309310
1. Click **Publish API**.
310-
1. From the **Portal** dropdown menu, select "test".
311+
1. From the **Portal** dropdown menu, select your Dev Portal.
311312
1. From the **Authentication strategy** dropdown menu, select "Disabled".
312313
1. Click **Public**.
313314
1. Click **Publish API**.
@@ -316,4 +317,4 @@ Your API package will now be published to your Dev Portal. Published API package
316317

317318
## Validate
318319

319-
Now that you've published your API package, you can verify that it was successfully published to your Dev Portal's URL.
320+
Now that you've published your API package, you can verify that it was successfully published by navigating to your Dev Portal's URL. You can find your Dev Portal's URL by navigating to the [Dev Portal overview](https://cloud.konghq.com/portals/) in the {{site.konnect_short_name}} UI.
Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,8 @@
11
For this tutorial, you’ll need a Dev Portal pre-configured. If you don't have these settings already configured, follow these steps to pre-configure it:
22

33
1. In the {{site.konnect_short_name}} sidebar, click **Dev Portal**.
4-
1. Click **New portal** to [create a Dev Portal](https://cloud.konghq.com/portals/create).
4+
1. Click [**New portal**](https://cloud.konghq.com/portals/create).
5+
1. Enter a name for your Dev Portal.
6+
1. Click **Create and continue**.
7+
1. Customize your Dev Portal's appearance.
8+
1. Click **Save**.

0 commit comments

Comments
 (0)