From f03bb5254cef45941ca405b8f798d5891720dee7 Mon Sep 17 00:00:00 2001 From: Teal Larson Date: Wed, 4 Mar 2026 10:29:08 -0500 Subject: [PATCH 1/5] Improve search empty state with quick links Replace the unhelpful "Start typing" message with a quick links grid pointing to common doc sections. Also fix ghost results showing through by hiding Hits when there is no query. Co-Authored-By: Claude Sonnet 4.6 --- app/_components/algolia-search.tsx | 65 +++++++++++++++++++++++++----- 1 file changed, 55 insertions(+), 10 deletions(-) diff --git a/app/_components/algolia-search.tsx b/app/_components/algolia-search.tsx index 3a116acce..8d81d688d 100644 --- a/app/_components/algolia-search.tsx +++ b/app/_components/algolia-search.tsx @@ -1,7 +1,15 @@ "use client"; import { liteClient as algoliasearch } from "algoliasearch/lite"; -import { Search } from "lucide-react"; +import { + BookOpen, + Code, + Search, + Server, + Shield, + Wrench, + Zap, +} from "lucide-react"; import { useEffect, useState } from "react"; import { Configure, @@ -166,15 +174,57 @@ function SearchHit({ hit }: { hit: DocSearchRecord }) { ); } +const QUICK_LINKS = [ + { title: "Get started", href: "/en/get-started", icon: BookOpen }, + { title: "Quickstarts", href: "/en/get-started/quickstarts", icon: Zap }, + { title: "Tools", href: "/en/resources/tools", icon: Wrench }, + { + title: "Auth providers", + href: "/en/references/auth-providers", + icon: Shield, + }, + { title: "API reference", href: "/en/references/api", icon: Code }, + { title: "MCP servers", href: "/en/references/mcp", icon: Server }, +]; + function EmptyQuery() { const { indexUiState } = useInstantSearch(); if (indexUiState.query) { return null; } return ( -

- Start typing to search the docs… -

+
+

+ Quick links +

+
+ {QUICK_LINKS.map((link) => ( + + + {link.title} + + ))} +
+
+ ); +} + +function ConditionalHits() { + const { indexUiState } = useInstantSearch(); + if (!indexUiState.query) { + return null; + } + return ( + ( + + )} + /> ); } @@ -275,12 +325,7 @@ export function AlgoliaSearch() {
- ( - - )} - /> +
) : ( From f722c6dca45097eb64374ce1537b435d55e45582 Mon Sep 17 00:00:00 2001 From: Teal Larson Date: Wed, 4 Mar 2026 10:45:52 -0500 Subject: [PATCH 2/5] Fix broken PagerDuty OAuth blog link (404) Replace dead blog URL with the active PagerDuty developer docs page for OAuth 2.0. Co-Authored-By: Claude Sonnet 4.6 --- app/en/references/auth-providers/pagerduty/page.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/en/references/auth-providers/pagerduty/page.mdx b/app/en/references/auth-providers/pagerduty/page.mdx index 52cfa1655..e13e71da0 100644 --- a/app/en/references/auth-providers/pagerduty/page.mdx +++ b/app/en/references/auth-providers/pagerduty/page.mdx @@ -75,7 +75,7 @@ To integrate with PagerDuty's API using OAuth 2.0, you'll need to register an ap -For detailed instructions, refer to PagerDuty's [OAuth 2.0 guide](https://www.pagerduty.com/blog/insights/build-sophisticated-apps-for-your-pagerduty-environment-using-oauth-2-0-and-api-scopes/) and [OAuth documentation](https://developer.pagerduty.com/docs/oauth-functionality). +For detailed instructions, refer to PagerDuty's [OAuth 2.0 documentation](https://developer.pagerduty.com/docs/oauth-2-functionality). Next, add the PagerDuty app to Arcade. From 5b677c96e666053d7ab1632cf3ce2f44491dc7c3 Mon Sep 17 00:00:00 2001 From: Teal Larson Date: Wed, 4 Mar 2026 10:48:53 -0500 Subject: [PATCH 3/5] Fix PagerDuty OAuth link to use working URL Previous URL also 404d. Use the Authorization Code Grant Flow docs page which is confirmed reachable. Co-Authored-By: Claude Sonnet 4.6 --- app/en/references/auth-providers/pagerduty/page.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/en/references/auth-providers/pagerduty/page.mdx b/app/en/references/auth-providers/pagerduty/page.mdx index e13e71da0..648b4b4aa 100644 --- a/app/en/references/auth-providers/pagerduty/page.mdx +++ b/app/en/references/auth-providers/pagerduty/page.mdx @@ -75,7 +75,7 @@ To integrate with PagerDuty's API using OAuth 2.0, you'll need to register an ap -For detailed instructions, refer to PagerDuty's [OAuth 2.0 documentation](https://developer.pagerduty.com/docs/oauth-2-functionality). +For detailed instructions, refer to PagerDuty's [OAuth 2.0 documentation](https://developer.pagerduty.com/docs/f14c5f7a16fd5-o-auth-2-0-authorization-code-grant-flow). Next, add the PagerDuty app to Arcade. From cb28f512ff17e51807ced906d46b64647e086f57 Mon Sep 17 00:00:00 2001 From: Teal Larson Date: Wed, 4 Mar 2026 10:51:53 -0500 Subject: [PATCH 4/5] Fix PagerDuty OAuth link to use correct URL Co-Authored-By: Claude Sonnet 4.6 --- app/en/references/auth-providers/pagerduty/page.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/en/references/auth-providers/pagerduty/page.mdx b/app/en/references/auth-providers/pagerduty/page.mdx index 648b4b4aa..1769c180f 100644 --- a/app/en/references/auth-providers/pagerduty/page.mdx +++ b/app/en/references/auth-providers/pagerduty/page.mdx @@ -75,7 +75,7 @@ To integrate with PagerDuty's API using OAuth 2.0, you'll need to register an ap -For detailed instructions, refer to PagerDuty's [OAuth 2.0 documentation](https://developer.pagerduty.com/docs/f14c5f7a16fd5-o-auth-2-0-authorization-code-grant-flow). +For detailed instructions, refer to PagerDuty's [OAuth 2.0 documentation](https://developer.pagerduty.com/docs/oauth-functionality). Next, add the PagerDuty app to Arcade. From 588d8ea2006cfe6a6f3538752b50ed9f47b862dc Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 4 Mar 2026 15:55:30 +0000 Subject: [PATCH 5/5] Regenerate clean markdown files --- public/_markdown/en/references/auth-providers/pagerduty.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/public/_markdown/en/references/auth-providers/pagerduty.md b/public/_markdown/en/references/auth-providers/pagerduty.md index 0516bf454..7c0b3d727 100644 --- a/public/_markdown/en/references/auth-providers/pagerduty.md +++ b/public/_markdown/en/references/auth-providers/pagerduty.md @@ -64,7 +64,7 @@ To integrate with PagerDuty’s API using OAuth 2.0, you’ll need to register a 1. After creating your app, you’ll receive your **Client ID** and **Client Secret** 2. **Important**: Copy and save these credentials immediately, as the Client Secret won’t be accessible again -For detailed instructions, refer to PagerDuty’s [OAuth 2.0 guide](https://www.pagerduty.com/blog/insights/build-sophisticated-apps-for-your-pagerduty-environment-using-oauth-2-0-and-api-scopes/)  and [OAuth documentation](https://developer.pagerduty.com/docs/oauth-functionality) . +For detailed instructions, refer to PagerDuty’s [OAuth 2.0 documentation](https://developer.pagerduty.com/docs/oauth-functionality) . Next, add the PagerDuty app to Arcade. @@ -258,7 +258,7 @@ PagerDuty Classic apps use two permission levels: For more details about PagerDuty’s OAuth permissions, refer to the [PagerDuty OAuth functionality docs](https://developer.pagerduty.com/docs/oauth-functionality#scopes) . -Last updated on January 30, 2026 +Last updated on February 27, 2026 [Notion](/en/references/auth-providers/notion.md) [Reddit](/en/references/auth-providers/reddit.md)