From 2c801c4be218e16cf3bce506de53a70fea825588 Mon Sep 17 00:00:00 2001 From: Geoffrey Gilmore Date: Thu, 22 May 2025 14:52:52 -0700 Subject: [PATCH] remove code nav from bitbucket extension docs --- docs/integration/bitbucket_server.mdx | 25 ------------------------- 1 file changed, 25 deletions(-) diff --git a/docs/integration/bitbucket_server.mdx b/docs/integration/bitbucket_server.mdx index 9e2c273cc..99cf126f7 100644 --- a/docs/integration/bitbucket_server.mdx +++ b/docs/integration/bitbucket_server.mdx @@ -22,12 +22,9 @@ Site admins can [configure Sourcegraph to respect Bitbucket Server / Bitbucket D We recommend installing the Sourcegraph Bitbucket plugin which adds the following features to your Bitbucket Server / Bitbucket Data Center instance: -- **Native code navigation**: users don't need to install the [Sourcegraph browser extension](#browser-extension) to get hover tooltips, go-to-definition, find-references, and code search while browsing files and viewing pull requests on Bitbucket Server / Bitbucket Data Center. - **Fast permission syncing** between Sourcegraph and Bitbucket Server / Bitbucket Data Center - **Webhooks with configurable scope**, which are used by and highly recommended for usage with [batch changes](/batch-changes/) -![Bitbucket Server / Bitbucket Data Center code navigation](https://sourcegraphstatic.com/bitbucket-code-intel-pr-short.gif) - ### Installation and requirements Install the Sourcegraph plugin for Bitbucket from the [Atlassian Marketplace](https://marketplace.atlassian.com/apps/1231975/sourcegraph-for-bitbucket?tab=overview&hosting=datacenter) or see the [bitbucket-server-plugin](https://github.com/sourcegraph/bitbucket-server-plugin) repository for instructions on how to manually install the plugin on your Bitbucket Server / Bitbucket Data Center instance. @@ -72,12 +69,6 @@ In order to update the plugin, follow the same steps as for installing it, which When the Sourcegraph instance connected to the Bitbucket Server plugin is updated, so will the code that's fetched by the plugin to enable native code navigation. No manual steps required. (See the [Technical Details](#technical-details) section on how this works.) -### Native code navigation - -Once the plugin is installed and the **Sourcegraph URL** is set under **Administration > Add-ons > Sourcegraph**, native code navigation is enabled when browsing code or pull requests on your Bitbucket Server / Bitbucket Data Center instance. - -To disable native code navigation, simply set **Sourcegraph URL** to an empty value. Note that this will also disable [Webhooks](#webhooks)! - ### Webhooks Once the plugin is installed, go to **Administration > Add-ons > Sourcegraph** to see a list of all configured webhooks and to create a new one. @@ -104,22 +95,6 @@ This section provides some technical insight into the Bitbucket Server plugin to You can find the full source code for the plugin at [github.com/sourcegraph/bitbucket-server-plugin](https://github.com/sourcegraph/bitbucket-server-plugin/). -#### Native code navigation - -The Bitbucket Server plugin provides **native code navigation** without users having to install the [Sourcegraph browser extension](/integration/browser_extension). - -It does that by fetching the required JavaScript code from the configured Sourcegraph instance and injecting it into the HTML that the Bitbucket Server / Bitbucket Data Center instance serves. See the [`sourcegraph-bitbucket.js`](https://github.com/sourcegraph/bitbucket-server-plugin/blob/master/src/main/resources/js/sourcegraph-bitbucket.js) file for how it does that. - -The code that's injected is the code of the [Sourcegraph browser extension](#browser-extension). It is hosted by your Sourcegraph instance in this case and adds the same code navigation functionality to all files and pull requests viewed on Bitbucket Server / Bitbucket Data Center. - -The code only talks to the Sourcegraph instance that's configured in the Bitbucket Server plugin configuration. It doesn't add any more load to the Bitbucker Server instance. - -No private code, private repository names, usernames, or any other specific data is sent somewhere else. The code will send usage information to the connected private Sourcegraph instance only, so that the site admins can see usage statistics. - -If it failed to load or talk to the Sourcegraph instance, messages are logged to the browser console. - -When the Sourcegraph instance is updated to a newer version, the embedded browser extension code that provides the native code navigation may also be updated. - #### Webhooks Bitbucket Server / Bitbucket Data Center natively only [provides **per-repository** webhooks](https://confluence.atlassian.com/bitbucketserver/managing-webhooks-in-bitbucket-server-938025878.html).