From e639a99ef76a319b6f4351acdb7cfcbc40e12ab4 Mon Sep 17 00:00:00 2001 From: Stefan Hengl Date: Thu, 13 Aug 2026 15:24:31 -0500 Subject: [PATCH 1/2] docs: add Diff Tour page Amp-Thread-ID: https://ampcode.com/threads/T-019ffcb4-8663-70b9-b64d-939a9c874e00 Co-authored-by: Amp --- docs/diff-tour/index.mdx | 20 ++++++++++++++++++++ src/data/navigation.ts | 4 ++++ 2 files changed, 24 insertions(+) create mode 100644 docs/diff-tour/index.mdx diff --git a/docs/diff-tour/index.mdx b/docs/diff-tour/index.mdx new file mode 100644 index 000000000..00cf1c113 --- /dev/null +++ b/docs/diff-tour/index.mdx @@ -0,0 +1,20 @@ +# Diff Tour + + + Diff Tour is a beta feature. It is not available on Sourcegraph.com and + requires acceptance of the [Sourcegraph AI + Terms](https://sourcegraph.com/terms/ai-terms). It does not consume credits + during beta. + + +Large diffs are hard to review. Unless you are familiar with the codebase, it is often not obvious where to start or which files contain only mechanical changes. Diff Tour turns a diff into a guided reading path. It places important files first, groups related files into sections, and explains the diff, each section, and individual files. + +## Open a Diff Tour + +Open a diff from the repository Compare page, by comparing branches on the Branches tab, or from a commit page. Select **Tour** next to **Changes**. + +For a diff on GitHub, use the [Sourcegraph browser extension](/integration/browser-extension) to open it in Sourcegraph, then select **Tour**. + +## Review a Diff Tour + +Read the tour from top to bottom. Open each file to review its changes and mark it as viewed as you go. Sourcegraph generates a tour once and caches the result. Other reviewers opening the same diff receive the cached tour. diff --git a/src/data/navigation.ts b/src/data/navigation.ts index 1280b43da..0c442ce6c 100644 --- a/src/data/navigation.ts +++ b/src/data/navigation.ts @@ -105,6 +105,10 @@ export const navigation: NavigationItem[] = [ } ] }, + { + title: 'Diff Tour', + href: '/diff-tour' + }, { title: 'Code Navigation', href: '/code-navigation', From 754f8d3945106c4519fd4145b35824160ed25f9a Mon Sep 17 00:00:00 2001 From: Stefan Hengl Date: Thu, 13 Aug 2026 15:30:56 -0500 Subject: [PATCH 2/2] Update index.mdx --- docs/diff-tour/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/diff-tour/index.mdx b/docs/diff-tour/index.mdx index 00cf1c113..966d1a59a 100644 --- a/docs/diff-tour/index.mdx +++ b/docs/diff-tour/index.mdx @@ -13,7 +13,7 @@ Large diffs are hard to review. Unless you are familiar with the codebase, it is Open a diff from the repository Compare page, by comparing branches on the Branches tab, or from a commit page. Select **Tour** next to **Changes**. -For a diff on GitHub, use the [Sourcegraph browser extension](/integration/browser-extension) to open it in Sourcegraph, then select **Tour**. +For a diff on GitHub, use the [Sourcegraph browser extension](/integration/browser-extension) to open it in Sourcegraph. ## Review a Diff Tour