Sourcegraph 3.2: (Mostly) no new features - Improved stability, setup, and documentation

By Ryan Blunden on March 20, 2019


My top feature request is: no new features. Just fix what's broken Credit: Rich Stevens

Sourcegraph is an open-source, self-hosted, cross-repository code search and navigation tool, with an efficient web interface and "feels-like-native" integration into your code host. Install or upgrade Sourcegraph.

Developing Sourcegraph in the open with a public product roadmap, and having a product used by tons of developers, means we receive a constant stream of feedback. A clear theme emerged:

“Improving x feature would help me more than adding new features.”

Seemingly small improvements can deliver huge productivity gains to engineers at companies such as Uber, Lyft, and Yelp, which have hundreds or thousands of developers using Sourcegraph to search and navigate thousands of repositories every day.

That’s why this release focuses on productivity and stability improvements that every Sourcegraph user can benefit from.

Onboarding flow for site admins and users

View on Vimeo

Getting your team on Sourcegraph is now easier thanks to the onboarding guide in the top navigation bar.

Site admins are guided through the steps to connect their repositories on their Sourcegraph instance and set up user authentication so it's ready to share.

Users are guided through performing their first search and code navigation actions.

Easier deployment to EC2 and DigitalOcean

View on Vimeo

View on Vimeo

You can run Sourcegraph locally with a single Docker command, but what about when you want to share Sourcegraph with your team?

We’ve made it easier to deploy Sourcegraph to your preferred cloud environments:

Better SSL documentation

Our NGINX SSL configuration documentation has been revised and improved, plus there's now a guide for creating self-signed certificates and how to get them trusted by your browser.

The 3.3 release will bring even more documentation improvements such as a new theme and better documentation for administrators first setting up a Sourcegraph instance.

Integrations refactoring and improvements

Sourcegraph integrations, such as our browser extension which brings hover tooltips and code navigation to GitHub, amplify the value that developers get from Sourcegraph every day.

Parts of our codebase are undergoing a large scale refactor, enabling existing extensions to receive enhancements faster, while adding new integrations becomes easier and quicker.

We’re also investing heavily in constantly running end-to-end tests to catch bugs sooner (when for example, a code host changes their DOM), and to ensure consistency of features across integrations such as cross repository jump-to-definition on GitHub, GitLab and BitBucket server.

Much of 3.2 is building the foundation upon which these improvements can be made and 3.3 is where the benefits of these changes will start to be seen.

Code intelligence improvements

View on Vimeo

Hover tooltips and jump-to-definition continue to be quicker and more efficient as you can see in the below demo of navigating around the Linux repository on Sourcegraph.com.

Changelog

Added

  • Sourcegraph can now automatically use the system's theme. To enable, open the user menu in the top right and make sure the theme dropdown is set to "System". This is currently supported on macOS Mojave with Safari Technology Preview 68 and later.
  • The github.exclude setting was added to the GitHub external service config to allow excluding repositories yielded by github.repos or github.repositoryQuery from being synced.

Changed

  • Symbols search is much faster now. After the initial indexing, you can expect code intelligence to be nearly instant no matter the size of your repository.
  • Massively reduced the number of code host API requests Sourcegraph performs, which caused rate limiting issues such as slow search result loading to appear.
  • The corsOrigin site config property is no longer needed for integration with GitHub, GitLab, etc., via the Sourcegraph browser extension. Only the Phabricator extension requires it.

Fixed

  • Fixed a bug where adding a search scope that adds a repogroup filter would cause invalid queries if repogroup:sample was already part of the query.
  • An issue where errors during displaying search results would not be displayed.

Removed

  • The "updateScheduler2" experiment is now the default and it's no longer possible to configure.

The changelog for this and previous releases is available on GitHub.

Thank you

Thank you to the many people who contributed to make Sourcegraph better since the last release!

Install or upgrade

Ready to install? Install Sourcegraph 3.2

Upgrading from 2.x or 3.0? See the migration guide


From the entire Sourcegraph team (@srcgraph), happy coding!