From ab0dabc79f5b34523f7a7d8c80fe81e50dccb620 Mon Sep 17 00:00:00 2001 From: Christian Adamini Date: Mon, 7 Oct 2024 02:47:35 +0200 Subject: [PATCH 1/5] Harmonize click link/button formatting --- .../accounts/managing-account-members.md | 4 ++-- .../accounts/managing-project-members.md | 4 ++-- docs/articles/accounts/zuplo-api-keys.md | 6 +++--- docs/articles/add-api-to-backstage.md | 4 ++-- docs/articles/archiving-requests-to-storage.md | 4 ++-- docs/articles/bonus-dynamic-rate-limiting.md | 4 ++-- docs/articles/custom-ci-cd.md | 2 +- docs/articles/custom-domains.md | 2 +- docs/articles/dev-portal-adding-pages.md | 2 +- docs/articles/dev-portal-keycloak-auth.md | 16 ++++++++-------- docs/articles/dev-portal-supabase-auth.md | 14 +++++++------- docs/articles/local-development-debugging.md | 2 +- docs/articles/rename-or-move-project.md | 2 +- docs/articles/step-1-setup-basic-gateway.md | 2 +- docs/articles/step-2-add-rate-limiting.md | 8 ++++---- docs/articles/step-3-add-api-key-auth.md | 12 ++++++------ docs/articles/step-4-deploying-to-the-edge.md | 2 +- docs/articles/testing-graphql.md | 2 +- docs/cli/authentication.md | 2 +- 19 files changed, 47 insertions(+), 47 deletions(-) diff --git a/docs/articles/accounts/managing-account-members.md b/docs/articles/accounts/managing-account-members.md index edc763ff..51b351f3 100644 --- a/docs/articles/accounts/managing-account-members.md +++ b/docs/articles/accounts/managing-account-members.md @@ -8,7 +8,7 @@ manage users in your account. ## Add Account Member -To start, navigate to the account settings page by clicking on your user icon in +To start, navigate to the account settings page by clicking your user icon in the top right corner of the screen and selecting "Settings" from the dropdown menu. @@ -40,6 +40,6 @@ the role from the drop down. ## Removing a Member -To remove a user from the account, click on the remove icon next to the user. +To remove a user from the account, click the remove icon next to the user. ![Remove Member](../../../public/media/managing-account-members/image-4.png) diff --git a/docs/articles/accounts/managing-project-members.md b/docs/articles/accounts/managing-project-members.md index 7c8e8475..8f10efe6 100644 --- a/docs/articles/accounts/managing-project-members.md +++ b/docs/articles/accounts/managing-project-members.md @@ -9,8 +9,8 @@ project level roles in order to grant them access to specific project resources. ## Add Project Member -To manage project members, navigate to the project settings page and click on -the "Members" tab. Here you can see a list of all members in the project and +To manage project members, navigate to the project settings page and click +the **Members** tab, which shows a list of all members in the project and their roles. ![Project Members](../../../public/media/managing-project-members/image-1.png) diff --git a/docs/articles/accounts/zuplo-api-keys.md b/docs/articles/accounts/zuplo-api-keys.md index 6e80019b..bfa45e69 100644 --- a/docs/articles/accounts/zuplo-api-keys.md +++ b/docs/articles/accounts/zuplo-api-keys.md @@ -12,9 +12,9 @@ accessible areas such as GitHub repositories. ## Creating an API Key -To start, navigate to the account settings page by clicking on your user icon in +To start, navigate to the account settings page by clicking your user icon in the top right corner of the screen and selecting "Settings" from the dropdown -menu. Click the "API Keys" tab to view the API keys in your account that you +menu. Click the **API Keys** tab to view the API keys in your account that you have access to. ![API Keys](../../../public/media/zuplo-api-keys/image.png) @@ -41,7 +41,7 @@ will need to create a new API key. ## Deleting an API Key API Keys can be deleted by selecting the delete button on the list page or by -opening the details page for the key and clicking the "Delete" button at the +opening the details page for the key and clicking the **Delete** button at the bottom of the page. ![Delete API Key](../../../public/media/zuplo-api-keys/image-2.png) diff --git a/docs/articles/add-api-to-backstage.md b/docs/articles/add-api-to-backstage.md index 2ba81f6f..d3fbb444 100644 --- a/docs/articles/add-api-to-backstage.md +++ b/docs/articles/add-api-to-backstage.md @@ -83,7 +83,7 @@ spec: ``` You should now be able to see your API under the APIs tab in Backstage. If you -navigate to your API and click the 'DEFINITION' tab - you can even preview your +navigate to your API and click the **DEFINITION** tab - you can even preview your OpenAPI spec. ![OpenAPI spec](../../public/media/add-api-to-backstage/image-6.png) @@ -126,7 +126,7 @@ Save and commit this file. ### 2/ Add your API Component to Backstage You can register existing APIs in your catalog directly from Backstage. Navigate -to the APIs tab, and click 'REGISTER EXISTING API'. +to the APIs tab, and click **REGISTER EXISTING API**. ![APIs list](../../public/media/add-api-to-backstage/image-5.png) diff --git a/docs/articles/archiving-requests-to-storage.md b/docs/articles/archiving-requests-to-storage.md index b76cb786..acbac69a 100644 --- a/docs/articles/archiving-requests-to-storage.md +++ b/docs/articles/archiving-requests-to-storage.md @@ -10,8 +10,8 @@ requests to Azure Blob Storage. We also have a post on First, let's set up Azure. You'll need a container in Azure storage ([docs](https://docs.microsoft.com/en-us/azure/storage/common/storage-account-create?tabs=azure-portal)). -Once you have your container you'll need the URL - you can get it on the -`properties` tab of your container as shown below. +Once you have your container you'll need the URL - click the +**Properties** tab of your container as shown below. > **Note** - this sample is available as a Zup It on GitHub - just click ZupIt! > to deploy to your Zuplo account: diff --git a/docs/articles/bonus-dynamic-rate-limiting.md b/docs/articles/bonus-dynamic-rate-limiting.md index 822e5603..a15d1aa6 100644 --- a/docs/articles/bonus-dynamic-rate-limiting.md +++ b/docs/articles/bonus-dynamic-rate-limiting.md @@ -50,7 +50,7 @@ information to rate limit them differently. ## 2/ Add a Custom Code Module Navigate back to the Code tab. Now add a new module to the files section by -clicking on the `+` next to the **modules** folder and choose new empty module. +clicking the `+` next to the **modules** folder and choose new empty module. Name the module `rate-limit.ts`. ![New module](../../public/media/step-3-add-rate-limiting/image-3.png) @@ -102,7 +102,7 @@ export function rateLimit(request: ZuploRequest, context: ZuploContext) { ## 3/ Update your Policy Now we'll reconfigure the rate-limiting policy to wire up our custom function. -Find the policy in the **Route Designer** and click edit. +Find the policy in the **Route Designer** and click **Edit**. ![Edit Policy](../../public/media/step-3-add-rate-limiting/image-4.png) diff --git a/docs/articles/custom-ci-cd.md b/docs/articles/custom-ci-cd.md index a421ce95..d2f1dfe4 100644 --- a/docs/articles/custom-ci-cd.md +++ b/docs/articles/custom-ci-cd.md @@ -26,7 +26,7 @@ following these steps: 1. Navigate to [portal.zuplo.com](https://portal.zuplo.com) and log in. 2. Select the account that you want to work on. -3. Click on the "Settings" tab and navigate to the "API Keys" section. +3. Click the **Settings** tab and navigate to the **API Keys** section. 4. Write some tests for your API. We provide a rich set of test helpers and utils based on BDD. You can see examples of tests at [samples](https://github.com/zuplo/zup-cli-example-project/tree/main/tests). diff --git a/docs/articles/custom-domains.md b/docs/articles/custom-domains.md index 6f38afb0..179db761 100644 --- a/docs/articles/custom-domains.md +++ b/docs/articles/custom-domains.md @@ -23,7 +23,7 @@ for your Zuplo project. ### 1. Navigate to your project's Custom Domain Settings Go to your project in the Zuplo portal and open to the **Settings** tab (1), -then select **Custom Domain** (2) and click on the `Add New Custom Domain` +then select **Custom Domain** (2) and click the **Add New Custom Domain** button to open the `New Custom Domain` configuration modal. ![Custom Domain](../../public/media/custom-domains/image.png) diff --git a/docs/articles/dev-portal-adding-pages.md b/docs/articles/dev-portal-adding-pages.md index 5f67f401..49696c2a 100644 --- a/docs/articles/dev-portal-adding-pages.md +++ b/docs/articles/dev-portal-adding-pages.md @@ -21,7 +21,7 @@ to get started. You can also create a new docs page via the new file button. ## Previewing Your Changes You can preview what your page will look like in the developer portal by -clicking the 'Markdown Preview' tab above the editor. +clicking the **Markdown Preview** tab above the editor. ![Markdown Preview](../../public/media/developer-portal/adding-pages/style-preview.png) diff --git a/docs/articles/dev-portal-keycloak-auth.md b/docs/articles/dev-portal-keycloak-auth.md index cf1d5b9a..f513d321 100644 --- a/docs/articles/dev-portal-keycloak-auth.md +++ b/docs/articles/dev-portal-keycloak-auth.md @@ -8,7 +8,7 @@ sidebar_label: Keycloak Setup This guide will walk you through setting up Keycloak as the authentication provider for your Zuplo hosted developer portal. -### 1/ Create OAuth Application +### 1. Create OAuth Application Navigate to your admin console and create a new client. The Client ID can be anything you want, but for this example, we will use `zuplo-dev-portal`. @@ -17,23 +17,23 @@ click "Next". ![Keycloak Client](../../public/media/dev-portal-keycloak-auth/image.png) -### 2/ Set the Client Capabilities +### 2. Set the Client Capabilities In the Authentication flow section, enable the "Standard flow" and disable "Direct access grants". Leave "Client authentication" and "Authorization" set to -"off". Click "Next". +"off". Click **Next**. ![Client Capabilities](../../public/media/dev-portal-keycloak-auth/image-1.png) -### 3/ Set the Login Settings +### 3. Set the Login Settings In the "Valid Redirect URIs" field, enter the URL of your Zuplo Dev Portal with the base path (this defaults to `/docs/`). Make sure you have the trailing slash -set. Click "Save". +set. Click **Save**. ![Login settings](../../public/media/dev-portal-keycloak-auth/image-3.png) -### 4/ Find the Issuer URL +### 4. Find the Issuer URL Open the "Realm settings" tab in your Keycloak admin console. And click the link to "OpenID Endpoint Configuration". This will open a JSON document. Find the @@ -44,13 +44,13 @@ Dev Portal. ![JSON file](../../public/media/dev-portal-keycloak-auth/image-5.png) -### 3/ Configure the Developer Portal +### 5. Configure the Developer Portal Inside of the Zuplo Developer portal navigate to the **Code Editor** tab and open the `dev-portal.json` file. Under the "Authentication" section, set the "Provider" to "OpenID Connect". Set the "Authority" value to the `issuer` value you copied from the JSON file in the previous step. Set the "Client ID" value to the value you set in step 1 (in our example this is `zuplo-dev-portal`). Click -"Save". +**Save**. ![developer portal settings](../../public/media/dev-portal-keycloak-auth/image-6.png) diff --git a/docs/articles/dev-portal-supabase-auth.md b/docs/articles/dev-portal-supabase-auth.md index 442dd267..e33c3d33 100644 --- a/docs/articles/dev-portal-supabase-auth.md +++ b/docs/articles/dev-portal-supabase-auth.md @@ -93,8 +93,8 @@ Or in the JSON file: Before we leave the Zuplo Portal, you’ll need to grab your Zuplo API key. This key is used to securely connect your Supabase Auth App with the Developer -Portal. From the side nav, go to your Project Settings and then click on Zuplo -API Keys. Copy your API key. +Portal. From the side nav, go to your Project Settings and then click **Zuplo +API Keys**. Copy your API key. ![img](../../public/media/supabase-auth/copy-key-updated.png) @@ -381,10 +381,10 @@ to sign into your Supabase project via the Developer Portal ``` 5. Deploy your code (make sure to set an environment variable for you - ZUPLO_API_KEY) and navigate to your Dev Portal. Then click the “Sign In” + ZUPLO_API_KEY) and navigate to your Dev Portal. Then click the **Sign In** button 6. You should be redirected to your Supabase Auth App. Enter the email and - password of an existing user and click “Sign In”. + password of an existing user and click **Sign In**. 7. You will be redirected back to the Dev portal and be signed into your Supabase account! @@ -414,7 +414,7 @@ how to sign them out. ``` 2. Deploy your code and navigate to your Dev Portal. Sign in if you aren’t - already. Then click your user icon and “Logout” + already. Then click your user icon and **Logout** 3. You should now be signed out of your Supabase Account @@ -490,9 +490,9 @@ need to have completed the Sign Up Support section above first** You should now see a GitHub button on your login page -4. Deploy your code and navigate to your Dev Portal. Then click the “Sign In” +4. Deploy your code and navigate to your Dev Portal. Then click the **Sign In** button -5. You should be redirected to your Supabase Auth App. Click the “GitHub” button +5. You should be redirected to your Supabase Auth App. Click the **GitHub** button 6. You will be redirected to the GitHub OAuth flow. Sign into GitHub if you aren’t already, and navigate through the flow 7. You will be redirected back to the Dev portal and be signed into your GitHub diff --git a/docs/articles/local-development-debugging.md b/docs/articles/local-development-debugging.md index 213b72f8..b5cd1ce9 100644 --- a/docs/articles/local-development-debugging.md +++ b/docs/articles/local-development-debugging.md @@ -33,7 +33,7 @@ npx @zuplo/cli dev --debug-port 9229 ``` 3. Switch to the View > Run and Debug in VS Code. You can now attach the - debugger by selecting "Zuplo Gateway" and clicking the green triangle. + debugger by selecting **Zuplo Gateway** and clicking the green triangle. ![VS code debugging](../../public/media/local-development-debugging/image.png) diff --git a/docs/articles/rename-or-move-project.md b/docs/articles/rename-or-move-project.md index d3a044d0..91a834bd 100644 --- a/docs/articles/rename-or-move-project.md +++ b/docs/articles/rename-or-move-project.md @@ -26,7 +26,7 @@ correct name. Choose the `Advanced` option on the new project dialog. ![Import existing project](../../public/media/source-control/image-1.png) You should see a list of Orgs and Repos - pick the source repo you wanted to -move and click Create Project from Repository. +move and click **Create Project from Repository**. Your new project will now be connected to this repo and ready to go. diff --git a/docs/articles/step-1-setup-basic-gateway.md b/docs/articles/step-1-setup-basic-gateway.md index c4186539..5d5494b4 100644 --- a/docs/articles/step-1-setup-basic-gateway.md +++ b/docs/articles/step-1-setup-basic-gateway.md @@ -40,7 +40,7 @@ quick overview of them: ![Your First Route](../../public/media/step-1-setup-basic-gateway/image-14.png) Save your new route (you can click the three-dot menu next to `routes.oas.json` -and then click Save, or press CMD+S). +and then click **Save**, or press **CMD+S**). You can quickly test this route by clicking the **Test** button next to the **Path** field. You can use the built in test tool or click the URL to open in a diff --git a/docs/articles/step-2-add-rate-limiting.md b/docs/articles/step-2-add-rate-limiting.md index 9784514b..43af18b0 100644 --- a/docs/articles/step-2-add-rate-limiting.md +++ b/docs/articles/step-2-add-rate-limiting.md @@ -34,7 +34,7 @@ pipeline. ![Add policy](../../public/media/step-2-add-rate-limiting/image.png) -Search for the rate limiting policy (not the "Complex" one) and click on it! +Search for the rate limiting policy (not the "Complex" one) and click it. ![Add rate-limiting policy](../../public/media/step-2-add-rate-limiting/image-2.png) @@ -45,7 +45,7 @@ rest of the policy's documentation and configuration in the right panel. ![Rate limiting policy](../../public/media/step-2-add-rate-limiting/image-3.png) -Click 'OK' to apply the policy, and then save your changes to redeploy. +To apply the policy, click **OK**. Then, save your changes to redeploy. ## 2/ Testing your Policy @@ -62,8 +62,8 @@ Your rate limiting policy is now intercepting excess requests, protecting the Whenever you deploy a new endpoint on Zuplo, it will automatically be added to your [autogenerated developer documentation portal](./developer-portal.md). -To access your API's developer portal, click the "Gateway deployed" button in -your toolbar and click on the link under Developer Portal. +To access your API's developer portal, click the **Gateway deployed** button in +your toolbar and click the link under Developer Portal. ![Developer portal menu](../../public/media/step-2-add-rate-limiting/image-5.png) You can also find this link in the Getting Started section of the portal, every time you navigate to your project. diff --git a/docs/articles/step-3-add-api-key-auth.md b/docs/articles/step-3-add-api-key-auth.md index 0ebaeb77..81943e89 100644 --- a/docs/articles/step-3-add-api-key-auth.md +++ b/docs/articles/step-3-add-api-key-auth.md @@ -56,7 +56,7 @@ If you test your route, you should get a 401 Unauthorized response ## 2/ Set up an API Key In order to call your API, you need to configure an API consumer. Go to -**Services**, then click "Configure" on the "API Key Service". +**Services**, then click **Configure** on the "API Key Service". ![API Key Service](../../public/media/step-3-add-api-key-auth/image-2.png) @@ -74,15 +74,15 @@ Let's break down the configuration needed. plan, organization, etc. Go ahead and fill in `test-consumer` for the Subject. Add your own email as a -Key manager, and leave the metadata empty for now. Click 'Save consumer' once +Key manager, and leave the metadata empty for now. Click **Save consumer** once you're done. ![New Consumer](../../public/media/step-3-add-api-key-auth/image-3.png) ## 3/ Copy your API Key -After your API Key consumer is created, click the copy button (next to the eye -icon) to copy your new API Key. +After your API Key consumer is created, copy your new API Key by clicking the copy button (next to the eye +icon). ![Copy Key](../../public/media/step-3-add-api-key-auth/image-4.png) @@ -115,8 +115,8 @@ management into your existing dashboard. See Whenever you deploy a new endpoint on Zuplo, it will automatically be added to your [autogenerated developer documentation portal](./developer-portal.md). -To access your API's developer portal, click the "Gateway deployed" button in -your toolbar and click on the link under Developer Portal. +To access your API's developer portal, click the **Gateway deployed** button in +your toolbar and click the link under Developer Portal. ![Developer portal menu](../../public/media/step-2-add-rate-limiting/image-5.png) When you use certain policies like API keys, Zuplo will document properties like diff --git a/docs/articles/step-4-deploying-to-the-edge.md b/docs/articles/step-4-deploying-to-the-edge.md index de592ce8..dee6bc73 100644 --- a/docs/articles/step-4-deploying-to-the-edge.md +++ b/docs/articles/step-4-deploying-to-the-edge.md @@ -150,7 +150,7 @@ environment we want to update first). Click **Create pull request**. ![GitHub PR](https://cdn.zuplo.com/assets/875b164d-b7ef-4f46-9cdb-8d59354b5b93.png) -When ready, click **Merge pull request** +When ready, click **Merge pull request**. ![Merge PR](https://cdn.zuplo.com/assets/e8c68072-35dc-462a-8161-7a44e40fa1df.png) diff --git a/docs/articles/testing-graphql.md b/docs/articles/testing-graphql.md index d6d96080..dacd6d95 100644 --- a/docs/articles/testing-graphql.md +++ b/docs/articles/testing-graphql.md @@ -16,7 +16,7 @@ API Test Console. 3. Convert your GraphQL Query and GraphQL Variables into a JSON body. You can use [this tool](https://datafetcher.com/graphql-json-body-converter) to do so easily -4. Paste the JSON Body into the test's Body field and click the Test button +4. Paste the JSON Body into the test's Body field and click the **Test** button ![Docs Folder](../../public/media/guides/testing-graphql/test-request.png) diff --git a/docs/cli/authentication.md b/docs/cli/authentication.md index e1a64341..be0150c0 100644 --- a/docs/cli/authentication.md +++ b/docs/cli/authentication.md @@ -15,7 +15,7 @@ by following these steps: 1. Navigate to [portal.zuplo.com](https://portal.zuplo.com) and log in. 2. Select the account that you want to work on. -3. Click on the "Settings" tab and navigate to the "API Keys" section. Select an +3. Click the **Settings** tab and navigate to the "API Keys" section. Select an existing API Key or create a new one to use with the CLI. Most commands take an `--api-key` argument. For example, to list your available From 28855d5cc2f265f950c330d6613d08290f9b24c9 Mon Sep 17 00:00:00 2001 From: Christian Adamini Date: Mon, 7 Oct 2024 02:51:34 +0200 Subject: [PATCH 2/5] Revert list item style to standard --- docs/articles/dev-portal-keycloak-auth.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/articles/dev-portal-keycloak-auth.md b/docs/articles/dev-portal-keycloak-auth.md index f513d321..04527bb5 100644 --- a/docs/articles/dev-portal-keycloak-auth.md +++ b/docs/articles/dev-portal-keycloak-auth.md @@ -17,7 +17,7 @@ click "Next". ![Keycloak Client](../../public/media/dev-portal-keycloak-auth/image.png) -### 2. Set the Client Capabilities +### 2/ Set the Client Capabilities In the Authentication flow section, enable the "Standard flow" and disable "Direct access grants". Leave "Client authentication" and "Authorization" set to @@ -25,7 +25,7 @@ In the Authentication flow section, enable the "Standard flow" and disable ![Client Capabilities](../../public/media/dev-portal-keycloak-auth/image-1.png) -### 3. Set the Login Settings +### 3/ Set the Login Settings In the "Valid Redirect URIs" field, enter the URL of your Zuplo Dev Portal with the base path (this defaults to `/docs/`). Make sure you have the trailing slash @@ -33,7 +33,7 @@ set. Click **Save**. ![Login settings](../../public/media/dev-portal-keycloak-auth/image-3.png) -### 4. Find the Issuer URL +### 4/ Find the Issuer URL Open the "Realm settings" tab in your Keycloak admin console. And click the link to "OpenID Endpoint Configuration". This will open a JSON document. Find the From 656db015ec59e144e2175bf13d0815165aaf748f Mon Sep 17 00:00:00 2001 From: Christian Adamini Date: Mon, 7 Oct 2024 02:51:54 +0200 Subject: [PATCH 3/5] Correct list item number --- docs/articles/dev-portal-keycloak-auth.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles/dev-portal-keycloak-auth.md b/docs/articles/dev-portal-keycloak-auth.md index 04527bb5..8c6f3ec3 100644 --- a/docs/articles/dev-portal-keycloak-auth.md +++ b/docs/articles/dev-portal-keycloak-auth.md @@ -44,7 +44,7 @@ Dev Portal. ![JSON file](../../public/media/dev-portal-keycloak-auth/image-5.png) -### 5. Configure the Developer Portal +### 5/ Configure the Developer Portal Inside of the Zuplo Developer portal navigate to the **Code Editor** tab and open the `dev-portal.json` file. Under the "Authentication" section, set the From 4f4645f4dd4ce2b5a4a9b627be9560efa2dc03f2 Mon Sep 17 00:00:00 2001 From: Christian Adamini Date: Mon, 7 Oct 2024 02:54:59 +0200 Subject: [PATCH 4/5] Remove on --- docs/articles/open-api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles/open-api.md b/docs/articles/open-api.md index 73d35d7d..9cfcf419 100644 --- a/docs/articles/open-api.md +++ b/docs/articles/open-api.md @@ -13,7 +13,7 @@ your default OpenAPI routing file (oas = 'open api specification'). You can use the Route Designer to build your routes, which will be creating an OpenAPI document in the background for you (check it out in the **JSON View**). -You can also **import an OpenAPI** document by clicking on the **Open API** tab. +You can also **import an OpenAPI** document by clicking the **Open API** tab. ![Import Open API](../../public/media/open-api/image-1.png) From e4a45ee9dca600a7f1200b75c048f94140f551b2 Mon Sep 17 00:00:00 2001 From: Christian Adamini Date: Mon, 7 Oct 2024 16:22:42 +0200 Subject: [PATCH 5/5] Revert to old sub heading style --- docs/articles/dev-portal-keycloak-auth.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles/dev-portal-keycloak-auth.md b/docs/articles/dev-portal-keycloak-auth.md index 8c6f3ec3..3df5b51d 100644 --- a/docs/articles/dev-portal-keycloak-auth.md +++ b/docs/articles/dev-portal-keycloak-auth.md @@ -8,7 +8,7 @@ sidebar_label: Keycloak Setup This guide will walk you through setting up Keycloak as the authentication provider for your Zuplo hosted developer portal. -### 1. Create OAuth Application +### 1/ Create OAuth Application Navigate to your admin console and create a new client. The Client ID can be anything you want, but for this example, we will use `zuplo-dev-portal`.