From f1feab257f6d3fe8161dc33bcf47a5072c4763e5 Mon Sep 17 00:00:00 2001 From: Quinn Slack Date: Thu, 3 Jan 2019 04:04:09 -0600 Subject: [PATCH] fix many broken links and outdated posts/sections (#72) Helps with https://github.com/sourcegraph/sourcegraph/issues/1515. Updates all links to point to https://docs.sourcegraph.com (instead of relying on redirects). Fixes many other things, such as: - Uses new terminology consistently (Sourcegraph, not Sourcegraph Server or Sourcegraph Data Center) - Links to https://docs.sourcegraph.com/integration/browser_extension instead of the Chrome and Firefox stores separately - References to old features that are now configured differently or that have been removed --- STYLEGUIDE.md | 2 +- blogposts/announcing-sourcegraph-2.md | 55 +- blogposts/announcing_sourcegraph_2.13.md | 11 +- ...e-with-the-sourcegraph-chrome-extension.md | 8 +- ...e-for-java-now-available-on-sourcegraph.md | 2 +- ...nd-lsp-language-server-protocol-support.md | 63 +-- ...w-available-for-java-on-sourcegraph-com.md | 4 +- ...igence-on-github-embedded-code-snippets.md | 4 +- blogposts/dotcom-new-language-support.md | 6 +- .../faster-smoother-github-code-browsing.md | 10 +- ...le-tree-navigation-on-github-yes-please.md | 2 +- .../great-code-search-bad-code-search.md | 2 +- .../great-code-search-for-aws-codecommit.md | 14 +- .../how-sourcegraph-builds-sourcegraph.md | 4 +- blogposts/introducing-sourcegraph-2-7.md | 44 +- .../introducing-sourcegraph-server-2-3.md | 48 +- .../introducing-sourcegraph-server-2-4.md | 45 +- .../introducing-sourcegraph-server-2-5.md | 43 +- .../introducing-sourcegraph-server-2-6.md | 35 +- blogposts/liveblogging-github-universe.md | 2 +- ...r-your-teams-github-code-on-sourcegraph.md | 44 -- ...ore-powerful-code-search-on-sourcegraph.md | 13 +- ...cales-with-the-language-server-protocol.md | 2 +- blogposts/poetically-simple-code-review.md | 16 +- ...werful-code-search-for-bitbucket-server.md | 8 +- ...connect-and-more-updates-to-sourcegraph.md | 18 +- blogposts/sourcegraph-2-10.md | 53 +- blogposts/sourcegraph-2-11-release-notes.md | 54 +- blogposts/sourcegraph-2-12-release-notes.md | 39 +- ...lously-huge-monorepos-lsp-a-graphql-api.md | 69 +-- ...rch-user-rollout-in-large-organizations.md | 104 +--- ...-browser-extensions-are-now-open-source.md | 6 +- ...igence-and-the-language-server-protocol.md | 12 +- ...s-manage-scale-and-perform-code-reviews.md | 2 +- ...d-a-url-for-every-function-in-the-world.md | 2 +- blogposts/why-chris-joined-sourcegraph.md | 2 +- docs/contact.md | 2 +- docs/master-plan.md | 2 +- docs/privacy.md | 2 +- docs/roadmap.md | 2 +- projects/pricing-packaging-changes.md | 2 +- projects/sourcegraph-for-gitlab.md | 2 +- website/src/EventLogger.tsx | 5 - .../src/components/BrowserInstallButtons.tsx | 4 +- website/src/components/Footer.tsx | 25 +- website/src/components/NavigationTabs.tsx | 64 --- website/src/css/components/_DocsSidebar.scss | 69 --- website/src/css/pages/_docs.scss | 161 ------ website/src/css/styles.scss | 2 - website/src/pages/contact/sales.tsx | 5 +- website/src/pages/jobs.tsx | 14 +- website/src/pages/pricing.tsx | 2 +- website/src/pages/product/browser.tsx | 176 ------ website/src/pages/product/server.tsx | 524 ------------------ website/src/templates/blogPostTemplate.tsx | 5 - website/src/templates/contentTemplate.tsx | 12 - website/static/_redirects | 2 + 57 files changed, 282 insertions(+), 1648 deletions(-) delete mode 100644 blogposts/more-control-over-your-teams-github-code-on-sourcegraph.md delete mode 100644 website/src/components/NavigationTabs.tsx delete mode 100644 website/src/css/components/_DocsSidebar.scss delete mode 100644 website/src/css/pages/_docs.scss delete mode 100644 website/src/pages/product/browser.tsx delete mode 100644 website/src/pages/product/server.tsx diff --git a/STYLEGUIDE.md b/STYLEGUIDE.md index 30475973546..f29816b6b6c 100644 --- a/STYLEGUIDE.md +++ b/STYLEGUIDE.md @@ -146,7 +146,7 @@ For consistency, all examples should use the following names (as appropriate). When letting users know they can contact us with questions, feedback, or issues, always use the phrasing below: -> Questions/feedback? Contact us at [@srcgraph](https://twitter.com/srcgraph) or , or file issues on our [public issue tracker](https://github.com/sourcegraph/issues/issues). +> Questions/feedback? Contact us at [@srcgraph](https://twitter.com/srcgraph) or , or file issues on our [public issue tracker](https://github.com/sourcegraph/sourcegraph/issues). The `FeedbackText` component in the [Sourcegraph repository](https://github.com/sourcegraph/sourcegraph) should be used when possible. diff --git a/blogposts/announcing-sourcegraph-2.md b/blogposts/announcing-sourcegraph-2.md index 60e4428ac9a..dc5f8e0c6a5 100644 --- a/blogposts/announcing-sourcegraph-2.md +++ b/blogposts/announcing-sourcegraph-2.md @@ -10,46 +10,29 @@ heroImage: //images.ctfassets.net/le3mxztn6yoo/4JC9PXHpviy2Om2AKa6Ime/4de7c31950 published: true --- +**Update:** This blog post has been edited to remove references to outdated features. -We’ve been hard at work on some major improvements to how you edit, search, and review code. Today we’re excited to announce four big new features. - -
-
- -
-
-

Introducing Sourcegraph Editor

-

- A more productive desktop code editor that connects to your code host so you can edit, search, and review across all your repositories. It works locally; your code never touches our servers. Built on Visual Studio Code and in private beta now (open source when the public beta begins). -

- Request early access -
-
- -
-
- -
-
-

Introducing Sourcegraph Server

-

Already used by many of our customers and now available to all companies, Sourcegraph Server gives you code search and intelligence across all your company’s private and public code. It integrates with multiple code hosts, editors, and code review tools to increase productivity throughout the developer workflow.

-

Sourcegraph Server is what powers Sourcegraph.com, and now you can run it inside your company's network.

- Request a demo -
-
- - - -

Explore open-source code with the new Sourcegraph.com and browser extensions

-Search and browse open-source code on Sourcegraph.com and using our browser extensions (on GitHub), with full code intelligence: go-to-definition, find-references, etc. The full power of Sourcegraph is always free for open source. +We’ve been hard at work on some major improvements to how you search, browse, and review code. Today we’re excited to announce several big new features. + +## Introducing Sourcegraph + +Already used by many of our customers and now available to all companies, Sourcegraph gives you code search and intelligence across all your company’s private and public code. It integrates with multiple code hosts, editors, and code review tools to increase productivity throughout the developer workflow. + +Sourcegraph is what powers Sourcegraph.com, and now you can run it inside your company's network. [Install a self-hosted Sourcegraph instance in 1 command.](https://docs.sourcegraph.com/#quickstart) + +## Explore open-source code with the new Sourcegraph.com and browser extensions + +Search and browse open-source code on Sourcegraph.com and using the [Sourcegraph browser extension](https://docs.sourcegraph.com/integration/browser_extension) (on GitHub), with full code intelligence: go-to-definition, find-references, etc. The full power of Sourcegraph is always free for open source. What’s new and different: + * A single search box to search code and repositories, with regular expression and other advanced query support * Streamlined interface for code navigation (with go-to-definition and find-references) -* Private code is now only supported in Editor and Server, so we can focus on our products that reach all developers on any code host, without any obstacles to adoption -

Use Sourcegraph at work

-We hear overwhelmingly from our users: "I love Sourcegraph on open-source code, and I want to use it for work." Our new products are built to make this even easier. You can use Sourcegraph Editor yourself and get Sourcegraph Server for your whole company. Your code never touches our servers, and both products connect directly to your cloud or enterprise code hosts to work across all of your repositories. +## Use Sourcegraph at work + +We hear overwhelmingly from our users: "I love Sourcegraph on open-source code, and I want to use it for work." Our new products are built to make this even easier. You can use Sourcegraph on your organization's code, and it all stays secure on your own network. Your code never touches our servers, and both products connect directly to your cloud or enterprise code hosts to work across all of your repositories. + +--- -Request early access to Sourcegraph Editor -Request a demo of Sourcegraph Server +[Install a self-hosted Sourcegraph instance in 1 command.](https://docs.sourcegraph.com/#quickstart) \ No newline at end of file diff --git a/blogposts/announcing_sourcegraph_2.13.md b/blogposts/announcing_sourcegraph_2.13.md index 3d1c5a568a3..d14ee94eb03 100644 --- a/blogposts/announcing_sourcegraph_2.13.md +++ b/blogposts/announcing_sourcegraph_2.13.md @@ -19,7 +19,6 @@ Sourcegraph 2.13 ships today, with several improvements: - [In-product documentation at `/help`](https://docs.sourcegraph.com/dev/documentation#sourcegraph-help) - [Per-user repository permissions](https://docs.sourcegraph.com/admin/repo/permissions) for GitLab, with more code hosts coming soon [Enterprise] - [Support for multiple authentication providers](https://docs.sourcegraph.com/admin/auth) [Enterprise] -- Many smaller fixes listed in the [CHANGELOG](https://github.com/sourcegraph/sourcegraph/blob/master/CHANGELOG.md#213) We're also shipping Sourcegraph extensions that add other new features: @@ -39,6 +38,10 @@ To enable these extensions on your Sourcegraph instance, visit **User menu > Ext **Ready to get Sourcegraph 2.13?** [Install](https://docs.sourcegraph.com/#quickstart) or [update](https://docs.sourcegraph.com/admin/updates) now. +## Changelog + +See the [Sourcegraph changelog](https://sourcegraph.com/github.com/sourcegraph/sourcegraph/-/blob/CHANGELOG.md) for a list of all changes in this release. + ## Thank you Thank you to the [open-source contributors](https://github.com/sourcegraph/sourcegraph) who helped make Sourcegraph even better: @@ -50,8 +53,8 @@ Thank you to the [open-source contributors](https://github.com/sourcegraph/sourc - [@yevbar](https://github.com/yevbar): default color theme ([PR #409](https://github.com/sourcegraph/sourcegraph/pull/409)) - [@ianlopshire](https://github.com/ianlopshire): use external URLs ([PR #269](https://github.com/sourcegraph/sourcegraph/pull/269)) -## Next up: Sourcegraph 3.0 preview +## Next up: Sourcegraph 3.0 -We're hard at work on the next major release, Sourcegraph 3.0. It will significantly improve language support for code intelligence, simplify deployment and site configuration, improve debuggability of code host integrations, and allow much more extensibility (including searching other types of things, such as GitHub issues and PR comments, rendered documentation, and log data). See the next couple months on the [Sourcegraph product roadmap](https://docs.sourcegraph.com/dev/roadmap#november-2018) for more details. Work has already begun on [sourcegraph/sourcegraph@`master`](https://github.com/sourcegraph/sourcegraph). +We're hard at work on the next major release, Sourcegraph 3.0. It will significantly improve language support for code intelligence, simplify deployment and site configuration, improve debuggability of code host integrations, and allow much more extensibility (including searching other types of things, such as GitHub issues and PR comments, rendered documentation, and log data). See the next couple months on the [Sourcegraph product roadmap](https://docs.sourcegraph.com/dev/roadmap) for more details. Work has already begun on [sourcegraph/sourcegraph@`master`](https://github.com/sourcegraph/sourcegraph). -A preview release (`3.0-preview`) will be ready in early November. If you're on Sourcegraph 2.x, you should update to 2.13 now (and wait until the non-preview release of 3.0 to update to 3.0). +If you're on Sourcegraph 2.x, you should update to 2.13 now and can upgrade to 3.0 when it is released. diff --git a/blogposts/browse-review-code-on-github-like-in-an-ide-with-the-sourcegraph-chrome-extension.md b/blogposts/browse-review-code-on-github-like-in-an-ide-with-the-sourcegraph-chrome-extension.md index c7839ebdafe..4cbe4bad6e2 100644 --- a/blogposts/browse-review-code-on-github-like-in-an-ide-with-the-sourcegraph-chrome-extension.md +++ b/blogposts/browse-review-code-on-github-like-in-an-ide-with-the-sourcegraph-chrome-extension.md @@ -12,15 +12,15 @@ published: true -Wouldn’t it be awesome if you could review, browse, and search code on GitHub as though you were in an IDE, with jump-to-definition, doc tooltips, and cross-references? We think so. That’s why we built the Sourcegraph [Chrome extension for GitHub.](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack) +Wouldn’t it be awesome if you could review, browse, and search code on GitHub as though you were in an IDE, with jump-to-definition, doc tooltips, and cross-references? We think so. That’s why we built the Sourcegraph [Chrome extension for GitHub](https://docs.sourcegraph.com/integration/browser_extension). _Update (June 22, 2016): Added support for pull requests and diffs._ -[**Install Chrome extension for GitHub.**] (https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack) And don’t let your team review any code until they get it, too!_For Go, Java, TypeScript, and JavaScript only; more languages_ [_coming soon_](https://sourcegraph.com/beta)_!_ +[**Install Chrome extension for GitHub.**] (https://docs.sourcegraph.com/integration/browser_extension) And don’t let your team review any code until they get it, too!_For Go, Java, TypeScript, and JavaScript only; more languages_ [_coming soon_](https://sourcegraph.com/beta)_!_ -The [Sourcegraph Chrome extension](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack) keeps you in flow while coding, with: +The [Sourcegraph Chrome extension](https://docs.sourcegraph.com/integration/browser_extension) keeps you in flow while coding, with: 1. **Go-to-definition:** When you’re browsing files or reviewing pull requests on GitHub, you can use the extension to click on anything in your code to jump to its definition, or hover to get documentation tooltips. 2. **Find usages:** See examples of how a function or type is used across your company’s code as well as open-source repositories on GitHub. @@ -39,7 +39,7 @@ It’s totally free. See what other devs are saying about it: * * * -### [I**nstall the Sourcegraph Chrome extension**](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack) +### [I**nstall the Sourcegraph Chrome extension**](https://docs.sourcegraph.com/integration/browser_extension) _Update (June 22, 2016): Added support for pull requests and diffs._ diff --git a/blogposts/code-intelligence-for-java-now-available-on-sourcegraph.md b/blogposts/code-intelligence-for-java-now-available-on-sourcegraph.md index 2d3d9e018f2..6f364155ed4 100644 --- a/blogposts/code-intelligence-for-java-now-available-on-sourcegraph.md +++ b/blogposts/code-intelligence-for-java-now-available-on-sourcegraph.md @@ -40,7 +40,7 @@ Every feature mentioned in this post is available now for Java on Sourcegraph.co Sourcegraph works within seconds on any revision of code and scales to large repositories. It even works for newly pushed revisions such as those submitted for code review. -[![](https://cdn-images-1.medium.com/max/1000/1*qgqyqzpJlLKgacUx-5QGwA.png)](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack?hl=en)Sourcegraph integrates with code review tools like GitHub pull requests. +[![](https://cdn-images-1.medium.com/max/1000/1*qgqyqzpJlLKgacUx-5QGwA.png)](https://docs.sourcegraph.com/integration/browser_extension?hl=en)Sourcegraph integrates with code review tools like GitHub pull requests. #### Code review integration diff --git a/blogposts/code-intelligence-for-more-languages-and-lsp-language-server-protocol-support.md b/blogposts/code-intelligence-for-more-languages-and-lsp-language-server-protocol-support.md index 77fae004c01..6631d0fd711 100644 --- a/blogposts/code-intelligence-for-more-languages-and-lsp-language-server-protocol-support.md +++ b/blogposts/code-intelligence-for-more-languages-and-lsp-language-server-protocol-support.md @@ -10,65 +10,6 @@ heroImage: //images.ctfassets.net/le3mxztn6yoo/t4Qpcq5kA0AYM24Ws4mOk/4edf5502a93 published: true --- +**Update:** Sourcegraph now uses [Sourcegraph extensions](https://docs.sourcegraph.com/extensions) for language support. This blog post has been removed to avoid confusion. -With code intelligence on Sourcegraph, you can navigate code more easily with hovers, -definitions, references, implementations, etc. It's all powered by language servers based on the [Language Server Protocol (LSP)](http://langserver.org) standard (Microsoft's [official LSP site](https://microsoft.github.io/language-server-protocol/) also has more information). - -Now, thanks to the amazing contributions of hundreds of developers in the LSP ecosystem, Sourcegraph 2.8 has support for 13 more languages. You can also [connect any other LSP-compliant language server](/docs/code-intelligence/adapting-language-servers) to Sourcegraph. - -While any spec-compliant language server will work with Sourcegraph, we're focusing testing and development on 13 new languages. That brings the full list of languages with code intelligence on Sourcegraph 19, including the 6 already supported languages: - -* [Go](/docs/code-intelligence/go) -* [JavaScript](/docs/code-intelligence/javascript) -* [TypeScript](/docs/code-intelligence/typescript) -* [Python](/docs/code-intelligence/python) -* [Java](/docs/code-intelligence/java) -* [PHP](/docs/code-intelligence/php) -* [Bash](/docs/code-intelligence/experimental-language-servers) (experimental) -* [Clojure](/docs/code-intelligence/experimental-language-servers) (experimental) -* [C++](/docs/code-intelligence/experimental-language-servers) (experimental) -* [C#](/docs/code-intelligence/experimental-language-servers) (experimental) -* [CSS](/docs/code-intelligence/experimental-language-servers) (experimental) -* [Dockerfile](/docs/code-intelligence/experimental-language-servers) (experimental) -* [Elixir](/docs/code-intelligence/experimental-language-servers) (experimental) -* [HTML](/docs/code-intelligence/experimental-language-servers) (experimental) -* [Lua](/docs/code-intelligence/experimental-language-servers) (experimental) -* [OCaml](/docs/code-intelligence/experimental-language-servers) (experimental) -* [R](/docs/code-intelligence/experimental-language-servers) (experimental) -* [Ruby](/docs/code-intelligence/experimental-language-servers) (experimental) -* [Rust](/docs/code-intelligence/experimental-language-servers) (experimental) - -## Use these new languages in Sourcegraph - -1. Install or upgrade to [Sourcegraph 2.8](/). -1. On Sourcegraph, in the site admin area, visit the **Code intelligence** page (`/site-admin/code-intelligence`) to see a list of all available language servers. -1. Click **Enable** to enable a language server. - -If you're not a site admin, ask your friendly site admin to follow these steps for you. - -See documentation on [using experimental language servers](/docs/code-intelligence/experimental-language-servers#using-an-experimental-language-server-on-sourcegraph-server) for more information. - -Here's a GIF of the experimental C# support: - - - -## Status: experimental - -This enhanced LSP support and language coverage is experimental. We'll be working with the LSP community, sponsoring maintainers, and submitting patches ourselves to improve the state of code intelligence as quickly as possible for these languages. - -We'll remove the "experimental" label from a language server when we have confidence it's fast and reliable for a wide variety of codebases. In the meantime, see the [caveats of experimental language servers](/docs/code-intelligence/experimental-language-servers#caveats-of-experimental-language-servers). - -To help us improve code intelligence, when using Sourcegraph, please report any issues you see: - -- If code intelligence isn't working on your repository, consult the language server's README for any language-specific required configuration or limitations. Treat it as though you were using an editor plugin for the language. You might need to add a config file, or slightly standardize your build system config, to make it work. It'll be worth it! -- If the problem seems specific to the language server, report it on the language server's own issue tracker. Otherwise, report it on the [Sourcegraph issue tracker](https://github.com/sourcegraph/issues) (and we'll file and often fix an upstream issue if appropriate). - -For more information, see ["Code intelligence overview"](/docs/code-intelligence). - -## Notes for language server developers - -For developers interested in hacking on language servers, adapting a language server for use with Sourcegraph is straightforward. It massively increases the potential audience of your language server to all developers on the web, regardless of editor and without the need to install/configure it individually. Any organization running Sourcegraph internally will be able to use it on all of their code, and we'll deploy it to Sourcegraph.com for use on all open-source code. - -See [how to adapt a language server for use with Sourcegraph](https://docs.sourcegraph.com/extensions/language_servers/adapting_existing_language_servers). - -We're also eager to sponsor people to build and improve open-source, LSP-based language servers. [Contact us](/contact) if you're interested, either as a part-time effort or to [join our team](https://github.com/sourcegraph/careers) as a full-time member. +We're still eager to sponsor people to build and improve open-source, LSP-based language servers. [Contact us](/contact) if you're interested, either as a part-time effort or to [join our team](https://github.com/sourcegraph/careers) as a full-time member. diff --git a/blogposts/code-intelligence-now-available-for-java-on-sourcegraph-com.md b/blogposts/code-intelligence-now-available-for-java-on-sourcegraph-com.md index 0415034e111..6bfbe8116ed 100644 --- a/blogposts/code-intelligence-now-available-for-java-on-sourcegraph-com.md +++ b/blogposts/code-intelligence-now-available-for-java-on-sourcegraph-com.md @@ -39,9 +39,9 @@ Global usage examples show you how other repositories use a given class or metho #### Code Intelligence in your GitHub pull requests -Java Code Intelligence on Maven-based projects is now also available in the Sourcegraph [GitHub Chrome extension](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack?hl=en). That means hover tooltips and jump-to-definition in GitHub pull requests and the code browser: +Java Code Intelligence on Maven-based projects is now also available in the Sourcegraph [GitHub Chrome extension](https://docs.sourcegraph.com/integration/browser_extension?hl=en). That means hover tooltips and jump-to-definition in GitHub pull requests and the code browser: -[![](https://cdn-images-1.medium.com/max/800/1*F-6teGnQ7HMFjAkSKwtf8Q.png)](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack)Doc tooltips and jump-to-definition on GitHub +[![](https://cdn-images-1.medium.com/max/800/1*F-6teGnQ7HMFjAkSKwtf8Q.png)](https://docs.sourcegraph.com/integration/browser_extension)Doc tooltips and jump-to-definition on GitHub #### Available in the cloud and on-premises diff --git a/blogposts/code-intelligence-on-github-embedded-code-snippets.md b/blogposts/code-intelligence-on-github-embedded-code-snippets.md index 38f803869ad..10d2c13cebc 100644 --- a/blogposts/code-intelligence-on-github-embedded-code-snippets.md +++ b/blogposts/code-intelligence-on-github-embedded-code-snippets.md @@ -11,7 +11,7 @@ published: true --- -At Sourcegraph, we think you deserve code intelligence whenever you’re looking at code. So, when GitHub [introduced embedded code snippets](https://github.com/blog/2415-introducing-embedded-code-snippets) for GitHub issues, we quickly updated the [Sourcegraph Chrome extension](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack) to add code intelligence to these snippets. +At Sourcegraph, we think you deserve code intelligence whenever you’re looking at code. So, when GitHub [introduced embedded code snippets](https://github.com/blog/2415-introducing-embedded-code-snippets) for GitHub issues, we quickly updated the [Sourcegraph Chrome extension](https://docs.sourcegraph.com/integration/browser_extension) to add code intelligence to these snippets. Code intelligence on embedded code snippets lets you jump to definition, find references, and search to get a deeper understanding of the referenced code. You can also use hover tooltips to quickly see type info and documentation without navigating away from the conversation. @@ -19,4 +19,4 @@ Check it out: ![EmbeddedSnippetIntelligence](//images.contentful.com/le3mxztn6yoo/UrsmRAa3EOGWiISoeiq26/2df156407145ac91fc97ca2a055c9417/EmbeddedSnippetIntelligence.gif) -Start using it by installing the [Sourcegraph Chrome extension](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack?hl=en). +Start using it by installing the [Sourcegraph Chrome extension](https://docs.sourcegraph.com/integration/browser_extension?hl=en). diff --git a/blogposts/dotcom-new-language-support.md b/blogposts/dotcom-new-language-support.md index dee68acc32e..3d9f8c91e13 100644 --- a/blogposts/dotcom-new-language-support.md +++ b/blogposts/dotcom-new-language-support.md @@ -5,7 +5,7 @@ publishDate: 2018-11-29T12:00-07:00 tags: [ "blog" ] -slug: java-php-experimental-language-servers-temporarily-unavailable +slug: java-php-experimental_language_servers-temporarily-unavailable heroImage: //images.ctfassets.net/le3mxztn6yoo/t4Qpcq5kA0AYM24Ws4mOk/4edf5502a936bbec90c262fa00355aed/sourcegraph-mark.png published: true --- @@ -35,7 +35,3 @@ Otherwise, you can [run a self-hosted instance of Sourcegraph 2.13](https://docs In the coming weeks and months, depending on the language. Our top priorities are Java and PHP (as well as introducing Swift support). See the [Sourcegraph roadmap](https://docs.sourcegraph.com/dev/roadmap) for a timeline of when these languages will be added back. If you don't see a language listed yet, we don't have a date to re-add it. If you'd like to contribute language support, let us know. We are [hiring software engineers](https://github.com/sourcegraph/careers), or we can sponsor you as a part-time contributor. - ---- - -Look out for the [Sourcegraph 3.0-preview](https://docs.sourcegraph.com/dev/roadmap#3-0-preview-2018-12-03) announcement next week, which will let you use the new language extensions on your own self-hosted Sourcegraph instance. [File an issue](https://github.com/sourcegraph/sourcegraph/issues) or [contact @srcgraph on Twitter](https://twitter.com/srcgraph) with questions. \ No newline at end of file diff --git a/blogposts/faster-smoother-github-code-browsing.md b/blogposts/faster-smoother-github-code-browsing.md index bdecf949000..80a115aff6b 100644 --- a/blogposts/faster-smoother-github-code-browsing.md +++ b/blogposts/faster-smoother-github-code-browsing.md @@ -19,6 +19,7 @@ We’re excited to announce more improvements to the Sourcegraph Chrome extensio In addition to the new features described below, the core functionality is faster and smoother: whenever you're viewing a file or reviewing a pull request, you can hover over code to see type signatures and documentation in a tooltip. Clicking will anchor the tooltip and let you jump to a definition, find references, or initiate a full-text search. ## Advanced code search + Our extension now provides fast, multi-repository grep search with regular expressions. Just select any code inside a GitHub repository and use the Sourcegraph tooltip to execute a search. Search results for supported languages have code intelligence, and every result file has inline authorship and blame information. ![sourcegraphAdvancedSearch](//images.contentful.com/le3mxztn6yoo/3CEYtcHfeUUioAsyMA0I8w/80f68e9142de1db153ee5d37e77430ce/sourcegraphAdvancedSearch.gif) @@ -32,17 +33,20 @@ In [supported languages](https://sourcegraph.com/help/languages), you can go to ![sourcegraphJumpToDefinition](//images.contentful.com/le3mxztn6yoo/OZKyrqcdSm4208saaUQyQ/7a8177f2ed6bb5dcf9e1a0c5aca3ffb3/sourcegraphJumpToDefinition.gif) -## Find References +## Find references + You can also see all callers of a function, property accesses, etc., just like in a powerful IDE. ![sourcegraphFindReferences](//images.contentful.com/le3mxztn6yoo/4vgpMXmNXW8Q2oIUwOSOcI/c89c8a00c44214751186314892268026/sourcegraphFindReferences.gif) ## View on Sourcegraph + By clicking the "Sourcegraph" button on a repository homepage or while viewing a file, you can now jump to Sourcegraph. (Many users asked for this because going to Sourcegraph is the first thing they do when they get to a repository on GitHub!) ## Get it now -[Install the Sourcegraph Chrome extension](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack?hl=en) from the Chrome Web Store. If you’ve already installed it, Chrome will automatically update the extension, so you’ll already have these new features. + +[Install the Sourcegraph browser extension for Chrome or Firefox](https://docs.sourcegraph.com/integration/browser_extension). If you’ve already installed it, your browser will automatically update the extension, so you’ll already have these new features. Feedback or questions? Tweet us [@srcgraph](https://twitter.com/srcgraph). -(If your company’s code is on GitHub Enterprise or some other code host, connect the browser extension to your instance of [Sourcegraph Server](https://about.sourcegraph.com/docs/server). The browser extension is also available for Firefox.) +(If your company’s code is on GitHub Enterprise or some other code host, connect the browser extension to a [self-hosted Sourcegraph instance](https://docs.sourcegraph.com). The browser extension is also available for Firefox.) diff --git a/blogposts/file-tree-navigation-on-github-yes-please.md b/blogposts/file-tree-navigation-on-github-yes-please.md index 2f2b7b44270..2f8aa53bc93 100644 --- a/blogposts/file-tree-navigation-on-github-yes-please.md +++ b/blogposts/file-tree-navigation-on-github-yes-please.md @@ -16,7 +16,7 @@ We’ve added a file tree to GitHub so that you can quickly explore an entire re ![FileTree](//images.contentful.com/le3mxztn6yoo/kW80vVfYMSG8MqIkeuWMO/09b960497b3f136f7d1c45c17ee13514/FileTree.gif) -Get started by downloading the [Sourcegraph for GitHub Chrome extension](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack?hl=en) +Get started by downloading the [Sourcegraph for GitHub Chrome extension](https://docs.sourcegraph.com/integration/browser_extension?hl=en) And then jump into a repository [https://github.com/hootsuite/atlantis/](https://github.com/hootsuite/atlantis/blob/master/cmd/bootstrap.go) diff --git a/blogposts/great-code-search-bad-code-search.md b/blogposts/great-code-search-bad-code-search.md index 4ea93135753..a9dd1e80123 100644 --- a/blogposts/great-code-search-bad-code-search.md +++ b/blogposts/great-code-search-bad-code-search.md @@ -20,4 +20,4 @@ Great code search understands your code and integrates well with your editor and Great code search helps you find usage examples, debug issues, understand code, assess the impact of changes, and see who to ask. It helps you write better code—and it lets your entire organization build better software more quickly. -At Sourcegraph, we’ve taken these lessons to heart. Sourcegraph Server gives you great code search for your organization’s code. Whether you’ve already seen great code search for yourself, or whether this post just speaks to you, you can [install Sourcegraph Server for free](/docs/server/) and start using it today. +At Sourcegraph, we’ve taken these lessons to heart. Sourcegraph gives you great code search for your organization’s code. Whether you’ve already seen great code search for yourself, or whether this post just speaks to you, you can [install Sourcegraph for free](https://docs.sourcegraph.com) and start using it today. diff --git a/blogposts/great-code-search-for-aws-codecommit.md b/blogposts/great-code-search-for-aws-codecommit.md index 0988a772caf..3a0b8e60f2c 100644 --- a/blogposts/great-code-search-for-aws-codecommit.md +++ b/blogposts/great-code-search-for-aws-codecommit.md @@ -16,13 +16,13 @@ published: true } -# Install Sourcegraph Server to get great code search on AWS CodeCommit +# Install Sourcegraph to get great code search on AWS CodeCommit -Sourcegraph brings great code search and understanding abilities to development teams using [AWS CodeCommit](https://aws.amazon.com/codecommit/). Code search helps your engineering team find usage examples, debug errors, reuse existing libraries and packages, and understand unfamiliar parts of your code base more quickly. Learn more about [Sourcegraph code search](/products/code-search/). +Sourcegraph brings great code search and understanding abilities to development teams using [AWS CodeCommit](https://aws.amazon.com/codecommit/). Code search helps your engineering team find usage examples, debug errors, reuse existing libraries and packages, and understand unfamiliar parts of your code base more quickly. Learn more about [Sourcegraph code search](https://docs.sourcegraph.com/user/search). Setting up Sourcegraph code search to work with AWS CodeCommit is quick and easy. -1. First, [install and run an instance of Sourcegraph Server](/docs/server/install/). Using Minikube, Sourcegraph Server can run on any machine or VM. +1. First, [install and run an instance of Sourcegraph](https://docs.sourcegraph.com/admin). 2. Create a AWS IAM user with programmatic access. CodeCommit-CreateUser @@ -41,7 +41,7 @@ Setting up Sourcegraph code search to work with AWS CodeCommit is quick and easy CodeCommit-PublicKey -6. Modify your `config.json` (which you created as part of installing Sourcegraph Server) to access your AWS CodeCommit repositories. You'll need to make two changes: +6. Modify your `config.json` (which you created as part of installing Sourcegraph) to access your AWS CodeCommit repositories. You'll need to make two changes: a. Set the `gitOriginMap` field to include a mapping of the form `aws/!ssh://${YOUR_SSH_KEY_ID}@${YOUR_SSH_CLONE_URL_PREFIX}/%`. Substitute the SSH key ID associated with the SSH key you added and the SSH clone URL prefix, which you can obtain by viewing the SSH clone URL of any of your repositories. It should look something like this: ``` @@ -55,9 +55,9 @@ Setting up Sourcegraph code search to work with AWS CodeCommit is quick and easy }, ``` -7. Update your Sourcegraph Server instance to reflect the changes you made to your `config.json` by running `sourcegraph-server-gen config.json ./helm-chart && helm upgrade sourcegraph ./helm-chart`.
+7. Update your Sourcegraph instance to reflect the changes you made to your `config.json` by running `sourcegraph-server-gen config.json ./helm-chart && helm upgrade sourcegraph ./helm-chart`.
8. Add your AWS CodeCommit repositories by navigating to `https://${YOUR_SOURCEGRAPH_URL}/aws/${REPO_NAME}`. -And that's it! Now you can search over all your AWS CodeCommit repositories at once or configure a search group that lets you and your team search over a targeted subset of repositories. You can also configure Sourcegraph to work with a variety of Enterprise SSO identity providers and additional code hosts. You can read more about customizations [in the docs](/docs/server/install/#production-configuration). +And that's it! Now you can search over all your AWS CodeCommit repositories at once or configure a search group that lets you and your team search over a targeted subset of repositories. You can also configure Sourcegraph to work with a variety of Enterprise SSO identity providers and additional code hosts. You can read more about customizations [in the Sourcegraph administrator docs](https://docs.sourcegraph.com/admin). -Install Sourcegraph Server +[Install a self-hosted Sourcegraph instance with 1 command.](https://docs.sourcegraph.com/#quickstart) diff --git a/blogposts/how-sourcegraph-builds-sourcegraph.md b/blogposts/how-sourcegraph-builds-sourcegraph.md index 2d1629b0fe8..4df40a69b77 100644 --- a/blogposts/how-sourcegraph-builds-sourcegraph.md +++ b/blogposts/how-sourcegraph-builds-sourcegraph.md @@ -14,8 +14,8 @@ Our product, [Sourcegraph,](/) lets software teams search and explore their code We'll be publishing a series of posts here about how we build Sourcegraph. A few things make Sourcegraph and our development process different from many other companies: - Our product is for developers, so our developers naturally have a larger role in product planning and user/customer interaction (compared to companies building products for salespeople, photographers, etc.). -- Our product needs to be super easy for a single developer to [set up](/docs/server), get code search and intelligence on their organization's codebase, and share with their entire team. -- Sourcegraph is self-hosted; organizations run the [Docker image](/docs/server/install) or [Kubernetes cluster](/docs/server/datacenter) for Sourcegraph on their own servers. We can't roll back or push out an automatic update. ([Sourcegraph.com](https://sourcegraph.com) is a public instance with only public code from GitHub.com and other sites; customers' code never touches our servers.) +- Our product needs to be super easy for a single developer to [set up](https://docs.sourcegraph.com/#quickstart), get code search and intelligence on their organization's codebase, and share with their entire team. +- Sourcegraph is self-hosted; organizations run the [Docker image](https://docs.sourcegraph.com/admin/install) or [Kubernetes cluster](https://docs.sourcegraph.com/admin/install/cluster) for Sourcegraph on their own servers. We can't roll back or push out an automatic update. ([Sourcegraph.com](https://sourcegraph.com) is a public instance with only public code from GitHub.com and other sites; customers' code never touches our servers.) - Unlike many other developer-facing products, developers directly interact with our product and its UI. It's not just running behind the scenes. All this means we need to communicate well internally and externally, and we need to ship a robust, high-quality product to customers on a consistent schedule. diff --git a/blogposts/introducing-sourcegraph-2-7.md b/blogposts/introducing-sourcegraph-2-7.md index 4ded14c4fc7..76e79616904 100644 --- a/blogposts/introducing-sourcegraph-2-7.md +++ b/blogposts/introducing-sourcegraph-2-7.md @@ -14,7 +14,7 @@ Sourcegraph 2.7 ships today, with tons of new features and improvements to help Sourcegraph gives your team code intelligence and search across all of your code--even up to 10,000s of repositories. It runs securely in your own network, takes 5 minutes to install, and is free to use (with paid upgrades starting at $5/user/month). -Ready to install or upgrade? **[Install Sourcegraph 2.7](/docs)** +Ready to install or upgrade? **[Install Sourcegraph 2.7](https://docs.sourcegraph.com)** **Key highlights of Sourcegraph 2.7:** @@ -25,20 +25,19 @@ Ready to install or upgrade? **[Install Sourcegraph 2.7](/docs)** * [Improved references panel](#find-implementations-and-improved-references-panel) * [Search from your browser's address bar](#omnibox-integration) * [Access tokens for API clients](#access-tokens-for-api-clients) -* [Federated code intelligence (experimental)](#federated-code-inteliigence-experimental) * [Analytics improvements for site admins](#better-analytics-for-site-admins) ## From zero to code intelligence in seconds -We’ve drastically simplified getting code intelligence up and running. When viewing a repository, the relevant language servers are now automatically enabled. For example, visiting a Go repository will now automatically download and run the Docker container for Go code intelligence. (This change does not affect Data Center users.) +We’ve drastically simplified getting code intelligence up and running. When viewing a repository, the relevant language servers are now automatically enabled. For example, visiting a Go repository will now automatically download and run the Docker container for Go code intelligence. (This change does not affect cluster deployments.) -The new code intelligence admin panel allows you to view and manage language servers. It lets you enable, disable, update, and restart language servers at the click of a button. For Data Center users, it shows the current status of language servers. Click **Code intelligence** in the site admin area to manage code intelligence. +The new code intelligence admin panel allows you to view and manage language servers. It lets you enable, disable, update, and restart language servers at the click of a button. For cluster deployments, it shows the current status of language servers. Click **Code intelligence** in the site admin area to manage code intelligence. ## Code intelligence in Phabricator diffs -You can now get code intelligence in Phabricator diffs. You can roll it out to your entire organization by running a single install script, without needing every person to install the browser extension. [Read the documentation](/docs/features/phabricator-extension) for full instructions. +You can now get code intelligence in Phabricator diffs. You can roll it out to your entire organization by running a single install script, without needing every person to install the browser extension. [Read the Phabricator integration documentation](https://docs.sourcegraph.com/integration/phabricator) for full instructions. ## Diffs in Sourcegraph, with code intelligence @@ -50,7 +49,7 @@ You can now view and browse diffs with code intelligence directly in Sourcegraph ## Find implementations and improved references panel -Sourcegraph can now answer "Which types implement this interface?" for any [language server](https://microsoft.github.io/language-server-protocol/) that supports the feature, for example Go. After clicking find references on an interface, click the **Implementations** tab in the references panel to view all implementations. +Sourcegraph can now answer "Which types implement this interface?" for any [extension](https://docs.sourcegraph.com/extensions) that supports the feature, for example Go. After clicking find references on an interface, click the **Implementations** tab in the references panel to view all implementations. We’ve also improved the references panel for all languages to also show the full docstring, all definitions, and external references grouped by calling repository. @@ -62,44 +61,19 @@ The Sourcegraph browser extension now ships with easier access to code search fr ![Search suggestions in omnibox](//images.ctfassets.net/le3mxztn6yoo/49kFQWTFRCkyQie4a8e402/e4620f246142af6bb887d47913044e08/2018-04-16_2.03.26_PM.gif) -We’ve also added a few CLI-like commands to help configure your extension. After typing `src`, type `:` to activate CLI mode and use these shortcuts: - -* `src :add-url ` add a new Sourcegraph URL - -* `src :set-url ` set your primary Sourcegraph URL - - ## Access tokens for API clients Users (and site admins) may now create and manage access tokens to authenticate API clients. Access tokens are currently only supported when using the builtin and http-header authentication providers (not OpenID or SAML). Click **Access tokens** in your user profile menu to create and manage your tokens. The site configuration option auth.disableAccessTokens disables this new feature. - -## Federated code intelligence (experimental) - -We’ve shipped an experimental feature which lets you jump-to-definition to public repositories that you may not have enabled on your Sourcegraph instance. This feature consults the index of open-source repositories on Sourcegraph.com when jumping to a public repository not on your instance. This is disabled by default; use `"experimentalFeatures": { "jumpToDefOSSIndex": "enabled" }` in your site configuration to enable it. - - ## Better analytics for site admins The site admin analytics page will now display the number of code intelligence actions each user has made, including hovers, jump to definitions, and find references, on the Sourcegraph instance or in a code host integration. -## Additional improvements +## Changelog -* The user and organization management UI has been greatly improved. Site admins may now administer all organizations (even those they aren't a member of) and may edit profile info and configuration for all users. +See the [Sourcegraph changelog](https://sourcegraph.com/github.com/sourcegraph/sourcegraph/-/blob/CHANGELOG.md) for a list of all changes in this release. -* If SSO is enabled (via OpenID or SAML) and the SSO system provides user avatar images and/or display names, those are now used by Sourcegraph. - -* Users can now tweet their feedback about Sourcegraph when clicking on the feedback smiley located in the navbar and filling out a Twitter feedback form. - -* Enable new search timeout behavior by setting `"experimentalFeatures": { "searchTimeoutParameter": "enabled"}` in your site config. - - * Adds a new timeout: parameter to customize the timeout for searches. It defaults to 10s and may not be set higher than 1m. - - * The value of the timeout: parameter is a string that can be parsed by [time.Duration](https://golang.org/pkg/time/#ParseDuration) (e.g. "100ms", "2s"). - -* Code intelligence indexes are now built for all repositories in the background, regardless of whether or not they are visited directly by a user. - -See the [changelog](/changelog) for a full list of improvements. +--- -Ready to upgrade? **[Install Sourcegraph 2.7](/docs)**. +Ready to upgrade? **[Install Sourcegraph 2.7](https://docs.sourcegraph.com)**. diff --git a/blogposts/introducing-sourcegraph-server-2-3.md b/blogposts/introducing-sourcegraph-server-2-3.md index 859aac5a29b..565491c7b5f 100644 --- a/blogposts/introducing-sourcegraph-server-2-3.md +++ b/blogposts/introducing-sourcegraph-server-2-3.md @@ -1,5 +1,5 @@ --- -title: 'Introducing Sourcegraph Server 2.3' +title: 'Introducing Sourcegraph 2.3' author: 'Quinn Slack' publishDate: 2017-12-05T00:00-08:00 tags: [ @@ -12,12 +12,12 @@ published: true Search code over all of your company's repositories, save and reuse common search queries and scopes, and do it all more quickly with style. This release also includes previews of diff/commit search and author/date filters, which help you debug issues and find usage examples in your company’s code. -Sourcegraph Server gives the power of [great code search](/products/code-search) to every developer at your company, so you can ship better code faster. It runs securely in your own network and is easy to install and upgrade. +Sourcegraph gives the power of [great code search](https://docs.sourcegraph.com/user/search) to every developer at your company, so you can ship better code faster. It runs securely in your own network and is easy to install and upgrade. Ready to install or upgrade? -**Install [Sourcegraph Server 2.3](/docs/server)** with a single command to get great code search today. Current customers can [upgrade now](/docs/server). +**Install [Sourcegraph 2.3](https://docs.sourcegraph.com)** with a single command to get great code search today. Current customers can [update now](https://docs.sourcegraph.com/admin/updates). -Key highlights of Sourcegraph Server 2.3: +Key highlights of Sourcegraph 2.3: * [Better GitHub.com and GitHub Enteprise integration](#better-githubcom-and-github-enterprise-integration) * [Light color theme](#light-color-theme) * [Organizations](#organizations) @@ -33,16 +33,17 @@ Key highlights of Sourcegraph Server 2.3: * [Features in preview](#other-features-in-preview) ## Better GitHub.com and GitHub Enterprise integration -Sourcegraph Server now integrates more closely with GitHub.com and GitHub Enterprise to synchronize the list of searchable repositories. You can now specify a token for a bot user with access to the precise set of repositories to make searchable on Sourcegraph Server. This works for public and private repositories. You can even connect Sourcegraph Server to GitHub.com and multiple GitHub Enterprise servers at the same time. + +Sourcegraph now integrates more closely with GitHub.com and GitHub Enterprise to synchronize the list of searchable repositories. You can now specify a token for a bot user with access to the precise set of repositories to make searchable on Sourcegraph. This works for public and private repositories. You can even connect your Sourcegraph instance to GitHub.com and multiple GitHub Enterprise servers at the same time. Previously, server admins needed to add each repository manually. That still works for any Git repository host, and we'll expand this easier integration method to support more hosts soon. -See how to set up Sourcegraph Server to search over repositories hosted on: +See how to set up Sourcegraph to search over repositories hosted on: -* [GitHub.com and GitHub Enterprise](/docs/server/config/#github-configuration) (new) -* [Phabricator](/docs/server/config/phabricator) (new) -* [AWS CodeCommit](/blog/great-code-search-for-aws-codecommit) -* [Bitbucket.org, Bitbucket Server, GitLab, and other repository hosts](/docs/server/config/repositories) +* [GitHub.com and GitHub Enterprise](https://docs.sourcegraph.com/integration/github) (new) +* [Phabricator](https://docs.sourcegraph.com/integration/phabricator) (new) +* [AWS CodeCommit](https://docs.sourcegraph.com/integration/aws_codecommit) (also see "[Great code search for AWS CodeCommit](/blog/great-code-search-for-aws-codecommit)") +* [Bitbucket.org, Bitbucket Server, GitLab, and other repository hosts](https://docs.sourcegraph.com/admin/repo/add) ## Light color theme By popular request, we've added a light color theme in addition to our current dark theme! It's not just aesthetic: we've heard from people who use Sourcegraph on their daily train commute and on the beach (really!), and the light color theme handles glare better. Click the sun/moon toggle next to your profile avatar to switch between the light and dark themes. @@ -53,23 +54,23 @@ By popular request, we've added a light color theme in addition to our current d ## Organizations You can now create and join organizations (also known as “orgs”). Organizations are named groups of users with an associated JSON settings file. These settings take effect for all users who are members of the organization. What kinds of settings, you might ask? This release includes custom search scopes and saved queries, and more features that rely on configuration will be rolling out soon. -Server admins can [create organizations that new users automatically join](/docs/server/config/tutorial#organizations), and any user can create organizations and invite new members from the settings page. +Server admins can [create organizations that new users automatically join](https://docs.sourcegraph.com/user/organizations), and any user can create organizations and invite new members from the settings page.
SS2.3 orgs
## Custom search scopes -Every project and team has a different set of repositories they commonly work with and search over. We've added [custom search scopes](/docs/search/#scope) to enable users and organizations to search over predefined subsets of files and repositories. Instead of typing the set of files and repositories you search over, you can now simply define a search scope and select it from the dropdown next to the search box whenever you need. +Every project and team has a different set of repositories they commonly work with and search over. We've added [custom search scopes](https://docs.sourcegraph.com/user/search/#scope) to enable users and organizations to search over predefined subsets of files and repositories. Instead of typing the set of files and repositories you search over, you can now simply define a search scope and select it from the dropdown next to the search box whenever you need.
SS2.3 settings and search scopes
## Saved queries -[Saved queries](/docs/search/#saved-queries) let you save and describe search queries so you can easily monitor the results on an ongoing basis. You might think of them as the beginning of “Google Alerts or IFTTT/Zapier for your code.” +[Saved queries](https://docs.sourcegraph.com/user/search/#saved-queries) let you save and describe search queries so you can easily monitor the results on an ongoing basis. You might think of them as the beginning of “Google Alerts or IFTTT/Zapier for your code.” You can create a saved query for anything searchable, including (with this release) diffs and commits across all branches of your repositories. Saved queries can be an early warning system for common problems in your code--and a way to monitor best practices, the progress of refactors, etc. -See some [examples of useful saved queries](/docs/search/#examples-of-useful-saved-queries), including: +See some [examples of useful saved queries](https://docs.sourcegraph.com/user/search/#examples-of-useful-saved-queries), including: * Recently security-related changes on all branches (which we recommend tech leads monitor every day) * Hacks and TODOs in code * New usages of specific functions @@ -81,13 +82,17 @@ See some [examples of useful saved queries](/docs/search/#examples-of-useful-sav ## Admin dashboard -Server admins now have a dashboard to view and manage users and usage. Go to the settings page and navigate to the admin tab to view the number of page views and search queries users have executed on Sourcegraph. Add admin users by adding usernames to the `adminUsername` field in your [server configuration](/docs/server/config/#configuration). + +Server admins now have a dashboard to view and manage users and usage. Go to **User menu > Site admin** to see the site admin area. Add admin users in the **Users** site admin page. ## More single sign-on (SSO) integrations: OpenID Connect and SAML -Sourcegraph Server now supports [single sign-on (SSO) user authentication](/docs/server/config/authentication) via OpenID Connect and SAML 2.0. This includes (but is not limited to) support for the following SSO providers: Okta, OneLogin, Ping Identity, Auth0, Salesforce Identity, and Microsoft Azure Active Directory. + +Sourcegraph now supports [single sign-on (SSO) user authentication](https://docs.sourcegraph.com/admin/auth) via OpenID Connect and SAML 2.0. This includes (but is not limited to) support for the following SSO providers: Okta, OneLogin, Ping Identity, Auth0, Salesforce Identity, and Microsoft Azure Active Directory. ## Search and code intelligence on GitHub.com in Chrome/Firefox -The Sourcegraph [Chrome extension](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack) and [Firefox extension](https://addons.mozilla.org/en-US/firefox/addon/sourcegraph-addon-for-github/) now support Sourcegraph Server. After entering the Sourcegraph Server URL in the browser extension settings page, a Sourcegraph search toggle icon will appear in the GitHub search box. Customers of Sourcegraph Enterprise can integrate with GitHub Enterprise and get code intelligence (hovers, go-to-definition, etc.) on GitHub.com and GitHub Enterprise. + +The [Sourcegraph browser extension (Chrome/Firefox)](https://docs.sourcegraph.com/integration/browser_extension) now supports self-hosted Sourcegraph instances. After entering the Sourcegraph URL in the browser extension's options menu (revealed by clicking on the Sourcegraph icon in the browser toolbar), you'll get code intelligence on GitHub.com or GitHub Enterprise. +
SS2.3 GitHub browser extension
@@ -126,7 +131,12 @@ To go along with diff and commit search, we’ve added new search filters. While * `after:”3 weeks ago”`, `before:”june 25, 2017”`, `before:”last thursday”`, etc., to filter by commit date ([example](https://sourcegraph.com/search?q=repo:golang/go%24+type:diff+/package+%5Cw%2B_test/+after:%222+months+ago%22+before:%221+month+ago%22&sq=)) * `message:”hello”` to show only commits or diffs whose commit message (including the full message body) contains “hello” ([example](https://sourcegraph.com/search?q=repo:Microsoft/TypeScript%24+type:commit+after:%222+weeks+ago%22+file:%5C.ts%24+message:%22fix%28es%29%3F+%23%22&sq=)) +## Changelog + +See the [Sourcegraph changelog](https://sourcegraph.com/github.com/sourcegraph/sourcegraph/-/blob/CHANGELOG.md) for a list of all changes in this release. + ## Upgrade today -Want Sourcegraph Server? **[Install Sourcegraph Server](/docs/server)** for free with a single command. -Current customers can [upgrade now](/docs/server/). +Want Sourcegraph? **[Install Sourcegraph](https://docs.sourcegraph.com/#quickstart)** for free with a single command. + +Current customers can [update now](https://docs.sourcegraph.com/admin/updates). diff --git a/blogposts/introducing-sourcegraph-server-2-4.md b/blogposts/introducing-sourcegraph-server-2-4.md index 00c61d7e026..4df57f57612 100644 --- a/blogposts/introducing-sourcegraph-server-2-4.md +++ b/blogposts/introducing-sourcegraph-server-2-4.md @@ -1,5 +1,5 @@ --- -title: 'Announcing Sourcegraph Server 2.4: free, powerful search for your private code' +title: 'Announcing Sourcegraph 2.4: free, powerful search for your private code' author: 'Quinn Slack' publishDate: 2018-01-09T00:00-08:00 tags: [ @@ -10,15 +10,14 @@ heroImage: //images.ctfassets.net/le3mxztn6yoo/4r2yOyPFbWAUSCgAKoQesO/74658437ab published: true --- -Sourcegraph Server 2.4 is here. It is now free for unlimited users and repositories, can be installed in minutes with a single `docker run` command, and is easily configurable in the new web-based site admin. This release also includes many performance and bug fixes, plus a better interface for monitoring search results. +Sourcegraph 2.4 is here. It is now free for unlimited users and repositories, can be installed in minutes with a single `docker run` command, and is easily configurable in the new web-based site admin. This release also includes many performance and bug fixes, plus a better interface for monitoring search results. -Sourcegraph Server gives the power of great code search to every developer at your company, so you can ship better code faster. It runs securely in your own network, takes 5 minutes to install, and is easy to upgrade. +Sourcegraph gives the power of great code search to every developer at your company, so you can ship better code faster. It runs securely in your own network, takes 5 minutes to install, and is easy to upgrade. -Ready to install or upgrade? **[Install Sourcegraph Server 2.4.](/docs/server)** Existing Sourcegraph Data Center customers can [upgrade](/docs/server/datacenter#upgrading-to-a-new-version-of-sourcegraph) now. +Ready to install or upgrade? **[Install Sourcegraph 2.4.](https://docs.sourcegraph.com)** Existing customers can [update](https://docs.sourcegraph.com/admin/updates) now. -Key highlights of Sourcegraph Server 2.4: +Key highlights of Sourcegraph 2.4: * [Easier installation](#easier-installation) -* [Free for unlimited repositories and users on a single server](#free-for-unlimited-repositories-and-users-on-a-single-server) * [Easier configuration](#easier-configuration) * [Search interface improvements](#search-interface-improvements) * [Monitor saved query results](#monitor-saved-query-results) @@ -26,21 +25,17 @@ Key highlights of Sourcegraph Server 2.4: * [Commit message search](#commit-message-search) * [New search filters: author, committer, before, after, and commit message](#new-search-filters-author-committer-before-after-and-commit-message) -### Easier installation - -We've made it easier than ever to start searching your code with Sourcegraph Server: [see the one-command `docker run` quickstart command](/docs/server). - -See the [installation documentation](/docs/server) for more information. +## New features -### Free for unlimited repositories and users on a single server +### Easier installation -Code search on Sourcegraph Server is now free on a single server for unlimited repositories and users. As you grow to hundreds or thousands of users and repositories, graduate from the single-server deployment to a highly scalable Kubernetes cluster with [Sourcegraph Data Center](/docs/server/datacenter). +We've made it easier than ever to start searching your code with Sourcegraph: [see the one-command `docker run` quickstart command](https://docs.sourcegraph.com). -See our [pricing](/pricing) page for more information. +See the [installation documentation](https://docs.sourcegraph.com) for more information. ### Easier configuration -The new site admin area makes it easier for administrators to configure and manage Sourcegraph Server. Site admins can click **Admin** in the upper right of any page to view the site admin area. +The new site admin area makes it easier for administrators to configure and manage Sourcegraph. Site admins can click **Admin** in the upper right of any page to view the site admin area.
@@ -48,7 +43,7 @@ The new site admin area makes it easier for administrators to configure and mana
-From here, click **Configuration** in the site admin menu to configure your Sourcegraph Server. The new in-app JSON site config editor makes it easy to add repositories from GitHub, GitHub Enterprise, and other sources, configure SSO, and change other settings. +From here, click **Configuration** in the site admin menu to configure your Sourcegraph instance. The new in-app JSON site config editor makes it easy to add repositories from GitHub, GitHub Enterprise, and other sources, configure SSO, and change other settings.
@@ -56,11 +51,11 @@ From here, click **Configuration** in the site admin menu to configure your Sour
-See the [configuration documentation](/docs/server/config) for more information, and see the [full configuration options](/docs/server/config/settings). +See the [configuration documentation](https://docs.sourcegraph.com/admin) for more information, and see the [full configuration options](https://docs.sourcegraph.com/admin/site_config/all). ### Search interface improvements -We've introduced a cleaner, more intuitive search interface in Sourcegraph Server 2.4. Saved search scopes appear as buttons on the search homepage, replacing the old scope dropdown. The selected scope is reflected in the search bar as part of the search query. +We've introduced a cleaner, more intuitive search interface in Sourcegraph 2.4. Saved search scopes appear as buttons on the search homepage, replacing the old scope dropdown. The selected scope is reflected in the search bar as part of the search query. ### Monitor saved query results @@ -88,7 +83,7 @@ You can now search over commit diffs using the `type:diff` operator in search qu But that's not all! For the intrepid, you can search within commit diffs on multiple branches by specifying them in a `repo:` field after the `@` sign. [See non-master-branch commits containing `const`](https://sourcegraph.com/search?q=r:Microsoft/vscode%24%40*refs/heads/:%5Erefs/heads/master+type:diff+const+after:%221+week+ago%22&sq=) in a public repository on Sourcegraph.com, for example. After the `@`, separate Git refs with `:`, specify Git ref globs by prefixing them with `*`, and exclude commits reachable from a ref by prefixing it with `^`. We'll improve documentation as this feature nears release. -See the [documentation](/docs/search#diff-search) for more information. +See the [documentation](https://docs.sourcegraph.com/user/search#diff-search) for more information. ### Commit message search Like diff search above, but use `type:commit` to search inside commit *messages*. [See all commits mentioning “bug” or “fix”](https://sourcegraph.com/search?q=r:golang/go%24+type:commit+after:%221+month+ago%22+bug%7Cfix&sq=) in a public repository on Sourcegraph.com, for example. @@ -99,7 +94,7 @@ Like diff search above, but use `type:commit` to search inside commit *messages* -See the [documentation](/docs/search#commit-search) for more information. +See the [documentation](https://docs.sourcegraph.com/user/search#commit-search) for more information. ### New search filters: author, committer, before, after, and commit message @@ -110,8 +105,12 @@ To go along with diff and commit search, we've added new search filters. * `after:"3 weeks ago"`, `before:"june 25, 2017"`, `before:"last thursday"`, etc., to filter by commit date ([example](https://sourcegraph.com/search?q=repo:golang/go%24+type:diff+/package+%5Cw%2B_test/+after:%222+months+ago%22+before:%221+month+ago%22&sq=)) * `message:"hello"` to show only commits or diffs whose commit message (including the full message body) contains "hello" ([example](https://sourcegraph.com/search?q=repo:Microsoft/TypeScript%24+type:commit+after:%222+weeks+ago%22+file:%5C.ts%24+message:%22fix%28es%29%3F+%23%22&sq=)) -See the [search documentation](/docs/search#query) for all filters and query tokens +See the [search documentation](https://docs.sourcegraph.com/user/search#query) for all filters and query tokens + +## Changelog + +See the [Sourcegraph changelog](https://sourcegraph.com/github.com/sourcegraph/sourcegraph/-/blob/CHANGELOG.md) for a list of all changes in this release. -### Upgrade today +## Upgrade today -**[Install Sourcegraph Server 2.4](/docs/server)** to bring powerful code search to your developers. +**[Install Sourcegraph 2.4](https://docs.sourcegraph.com)** to bring powerful code search to your developers. diff --git a/blogposts/introducing-sourcegraph-server-2-5.md b/blogposts/introducing-sourcegraph-server-2-5.md index 5b8f40d6bad..30eff223a4c 100644 --- a/blogposts/introducing-sourcegraph-server-2-5.md +++ b/blogposts/introducing-sourcegraph-server-2-5.md @@ -1,5 +1,5 @@ --- -title: 'Sourcegraph Server 2.5: Introducing code change alerts' +title: 'Sourcegraph 2.5: Introducing code change alerts' author: 'Quinn Slack' publishDate: 2018-02-08T00:00-08:00 tags: [ @@ -10,13 +10,13 @@ heroImage: //images.ctfassets.net/le3mxztn6yoo/KggIyqGq8ooo2qIU48K6S/54bfffd088d published: true --- -Monitor code changes with Google Alerts-style notifications, get code intelligence in reviews/PRs, and search over thousands of repositories in hundreds of milliseconds—all with Sourcegraph Server 2.5, shipping today. This release also includes other highly requested features, such as native GitLab support and enhanced search scopes (plus performance improvements and bug fixes). +Monitor code changes with Google Alerts-style notifications, get code intelligence in reviews/PRs, and search over thousands of repositories in hundreds of milliseconds—all with Sourcegraph 2.5, shipping today. This release also includes other highly requested features, such as native GitLab support and enhanced search scopes (plus performance improvements and bug fixes). -Sourcegraph Server gives the power of code search and intelligence to every developer at your company, so you can ship better code faster. It runs securely in your own network, takes 5 minutes to install, and is easy to upgrade. +Sourcegraph gives the power of code search and intelligence to every developer at your company, so you can ship better code faster. It runs securely in your own network, takes 5 minutes to install, and is easy to upgrade. -Ready to install or upgrade? **[Install Sourcegraph Server 2.5](/docs/server)** +Ready to install or upgrade? **[Install Sourcegraph 2.5](https://docs.sourcegraph.com)** -**Key highlights of Sourcegraph Server 2.5:** +**Key highlights of Sourcegraph 2.5:** * [Code change notifications](#code-change-notifications) * [Built-in saved searches](#built-in-saved-searches) * [Code intelligence](#code-intelligence) @@ -28,7 +28,7 @@ Ready to install or upgrade? **[Install Sourcegraph Server 2.5](/docs/server)** ### Code change notifications -We've added email and Slack notifications for saved searches, so you get "Google Alerts"-style notifications for any code change that matches a query. You can use this to get notified when there are API changes, new dependencies, use of certain OSS licenses (such as GPL), security- and authentication-related changes, AWS secret keys committed in code, etc. [Set up saved searches and notifications.](/docs/search#saved-searches) +We've added email and Slack notifications for saved searches, so you get "Google Alerts"-style notifications for any code change that matches a query. You can use this to get notified when there are API changes, new dependencies, use of certain OSS licenses (such as GPL), security- and authentication-related changes, AWS secret keys committed in code, etc. [Set up saved searches and notifications.](https://docs.sourcegraph.com/user/search#saved-searches)
@@ -54,11 +54,11 @@ Sourcegraph now ships with a selection of built-in, common saved searches. Click ### Code intelligence -Code intelligence can now be added to any Sourcegraph Server instance with a single command. (Previously it required the Kubernetes-based Data Center deployment option.) +Code intelligence can now be added to any Sourcegraph instance with a single command. (Previously it required the Kubernetes-based cluster deployment option.) -Code intelligence makes reviewing and navigating code easier with go-to-definition, find-references, and hover tooltips. By connecting the popular Sourcegraph browser extension to Sourcegraph Server, you can even get code intelligence inline on GitHub and GitHub Enterprise (on PRs and code files). +Code intelligence makes reviewing and navigating code easier with go-to-definition, find-references, and hover tooltips. By connecting the popular Sourcegraph browser extension to Sourcegraph, you can even get code intelligence inline on GitHub and GitHub Enterprise (on PRs and code files). -[Get code intelligence](/docs/code-intelligence/install) for Go, Python, JavaScript, TypeScript, Java, and PHP today. +[Get code intelligence](https://docs.sourcegraph.com/extensions/language_servers/install) for Go, Python, JavaScript, TypeScript, Java, and PHP today.
@@ -69,15 +69,17 @@ Code intelligence makes reviewing and navigating code easier with go-to-definiti ### Massive-scale code search -For [Data Center deployments](/docs/server/datacenter), we’ve shipped a hybrid search backend that offers blazing-fast searches over 10,000+ repositories, on the order of hundreds of milliseconds, while still giving you up-to-date results without any indexing delay. It intelligently merges results from indexed search and on-the-fly search, giving you the best of both worlds. Hybrid search is enabled by default in Sourcegraph Data Center. +For [cluster deployments](https://docs.sourcegraph.com/admin/install/cluster), we’ve shipped a hybrid search backend that offers blazing-fast searches over 10,000+ repositories, on the order of hundreds of milliseconds, while still giving you up-to-date results without any indexing delay. It intelligently merges results from indexed search and on-the-fly search, giving you the best of both worlds. + +Hybrid search is enabled by default in Sourcegraph cluster deployments. See "[Indexed search](https://docs.sourcegraph.com/admin/search#indexed-search)" for instructions on how to enable it in single-Docker-image deployments. ### GitLab support -You can now easily configure Sourcegraph to search across all of your GitLab projects (on GitLab.com, GitLab CE, and GitLab EE). Just put in your access token in site config (using the "Add GitLab projects" button), restart, and select which projects to enable. [See the documentation](/docs/server/config/repositories#gitlab-configuration) for full instructions. As always, repositories from code hosts other than GitHub and GitLab can be added through the [repos.list configuration option](/docs/server/config/repositories#sync-repositories-from-any-code-host). +You can now easily configure Sourcegraph to search across all of your GitLab projects (on GitLab.com, GitLab CE, and GitLab EE). Just put in your access token in site config (using the "Add GitLab projects" button), restart, and select which projects to enable. [See the documentation](https://docs.sourcegraph.com/integration/gitlab) for full instructions. As always, Git repositories from code hosts other than GitHub and GitLab can also be added. ### Improved search scopes UI -Search scopes are now accessible on every page to more easily filter your search. Click the down-arrow next to the search bar to view your scopes and refine your search. [See the documentation on adding search scopes](/docs/server/config/search-scopes). +Search scopes are now accessible on every page to more easily filter your search. Click the down-arrow next to the search bar to view your scopes and refine your search. [See the documentation on adding search scopes](https://docs.sourcegraph.com/user/search/scopes). ### Search scope pages @@ -93,7 +95,7 @@ Have an idea for a search scope that would be useful to your community? Tweet us ### Integrations settings page -We've made it easier to connect your Sourcegraph Server instance to the Sourcegraph browser extension and your browser's address bar search. Click **Integrations** in your personal settings area to install the browser extension and connect it to your Sourcegraph Server instance. You'll also find instructions for setting up Sourcegraph as a custom search engine in your browser's address bar. Site admins can now send users to this page to more easily roll out the browser extension and browser address bar search. +We've made it easier to connect your Sourcegraph instance to the Sourcegraph browser extension and your browser's address bar search. Click **Integrations** in your personal settings area to install the browser extension and connect it to your Sourcegraph instance. You'll also find instructions for setting up Sourcegraph as a custom search engine in your browser's address bar. Site admins can now send users to this page to more easily roll out the browser extension and browser address bar search.
@@ -101,17 +103,10 @@ We've made it easier to connect your Sourcegraph Server instance to the Sourcegr
-### Additional improvements: - -* Adding GitHub repositories using a personal access token no longer auto-clones all repositories. Now, after adding your GitHub token, go to the site admin repositories page and press **Enable** to kick off cloning for each repository you want to clone. -* Search by file path is now enabled by default (no need to opt in with `type:path`). If a file path in a repo matches your query, you'll see it in search results (even if its text contents don't match). -* Go code intelligence now fetches exact dependencies for [dep](https://github.com/golang/dep) users, in addition to the already supported Glide and godep. -* We’ve added documentation for deploying your Sourcegraph Server instance to the cloud using [Google Cloud Platform](/docs/server/deploy/gcp), [Amazon Web Services](/docs/server/deploy/aws), and [Digital Ocean](/docs/server/deploy/digitalocean) to make it easier to provide code search to your team. -* Sourcegraph Server instances periodically ping https://sourcegraph.com for update checks and with a single aggregate usage number. Starting with version 2.5, this ping is configured separately from the `disableTelemetry` site configuration option. To disable this ping, go to the site admin updates page or use the `update.channel` site configuration option. -* The default behavior in Sourcegraph Data Center now prohibits user signup by default unless the site admin enables it. To enable it, specify`"auth.allowSignup": true` in `config.json`, re-generate the Helm chart, and apply the chart to your Kubernetes cluster. -* In Sourcegraph Data Center, the configuration settings for adding language servers (for code intelligence) have changed. The old langGo, langPython, langJavaScript, langTypeScript, and langJava settings have been removed. To enable code intelligence, you now need to use the [new language server configuration settings](/docs/code-intelligence/install#enabling-code-intelligence-on-a-server-instance) +## Changelog +See the [Sourcegraph changelog](https://sourcegraph.com/github.com/sourcegraph/sourcegraph/-/blob/CHANGELOG.md) for a list of all changes in this release. -**Upgrade today** +## Upgrade today -**[Install Sourcegraph Server 2.5](/docs/server)** to bring powerful code search to your developers. +**[Install Sourcegraph 2.5](https://docs.sourcegraph.com)** to bring powerful code search to your developers. diff --git a/blogposts/introducing-sourcegraph-server-2-6.md b/blogposts/introducing-sourcegraph-server-2-6.md index 4cbf468b97e..5b73c90519d 100644 --- a/blogposts/introducing-sourcegraph-server-2-6.md +++ b/blogposts/introducing-sourcegraph-server-2-6.md @@ -1,5 +1,5 @@ --- -title: 'Introducing Sourcegraph Server 2.6: Symbol search for 75+ languages' +title: 'Introducing Sourcegraph 2.6: Symbol search for 75+ languages' author: 'Quinn Slack' publishDate: 2018-03-13T00:00-08:00 tags: [ @@ -10,14 +10,14 @@ heroImage: //images.ctfassets.net/le3mxztn6yoo/4umPKXWx0kSeIgw0SKQw8e/265b6eadb4 published: true --- -We’re excited to announce Sourcegraph Server 2.6, with tons of new features and improvements to help your team build better software. Search for and jump directly to symbols, search for the code you need more quickly, and set up Sourcegraph to search across all of your code--all available now. This release also comes with big improvements to configuration and authentication. +We’re excited to announce Sourcegraph 2.6, with tons of new features and improvements to help your team build better software. Search for and jump directly to symbols, search for the code you need more quickly, and set up Sourcegraph to search across all of your code--all available now. This release also comes with big improvements to configuration and authentication. Sourcegraph gives your team code search and intelligence across all of your code--even up to 10,000s of repositories. It runs securely in your own network, takes 5 minutes to install, and is free to use (with paid upgrades starting at $5/user/month). -Ready to install or upgrade? **[Install Sourcegraph Server 2.6](/docs/server)** +Ready to install or upgrade? **[Install Sourcegraph 2.6](https://docs.sourcegraph.com)** -**Key highlights of Sourcegraph Server 2.6:** +**Key highlights of Sourcegraph 2.6:** * [Symbol search for 75+ languages](#symbol-search-for-75-languages) * [Improved configuration flow](#improved-configuration-flow) * [Language search filter](#language-search-filter) @@ -26,7 +26,6 @@ Ready to install or upgrade? **[Install Sourcegraph Server 2.6](/docs/server)** * [Improvements to built-in authentication](#improvements-to-built-in-authentication) * [Bitbucket Server support](#bitbucket-server-support) * [Better Phabricator integration](#better-phabricator-integration) -* [Safari extension (beta)](#safari-extension-beta) ## Symbol search for 75+ languages @@ -43,8 +42,6 @@ You can also browse all symbols in a repository with the symbols sidebar. Click Changes to most site configuration options are now automatically detected and no longer require a server restart. After pressing Save on the site admin configuration page, the changes will take effect immediately (for most settings--if you need to restart to apply the changes, you'll see a notice). This makes it easier to configure Sourcegraph to search repositories on your code hosts (GitHub, GitHub Enterprise, GitLab, Bitbucket Server, AWS CodeCommit, and any other Git-based code host) without restarting the server. -See the [changelog](/changelog#configuration-changes) for a complete list of improvements we’ve made to configuration. - ## Language search filter Now, you can filter search results by programming language with the `lang:` filter. For example, use [`test lang:yaml`](https://sourcegraph.com/search?q=repogroup:sample+lang:yaml+test) for files containing `test` in YAML files, or `import lang:python` for [`import` statements in Python files](https://sourcegraph.com/search?q=repogroup:sample+lang:python+import). @@ -58,39 +55,33 @@ Filtering with search scopes is now smarter and dynamic. After executing a searc ## More documentation for scaling and deployment -We’ve added tons of information to the Sourcegraph Data Center documentation to better help you use Sourcegraph at your company. See the [scaling documentation](/docs/server/datacenter/scaling) for information on managing scaling your deployment. +We’ve added tons of information to the Sourcegraph cluster deployment documentation to better help you use Sourcegraph at your company. See the [cluster deployment documentation](https://docs.sourcegraph.com/admin/install/cluster) for information on managing and scaling your Sourcegraph cluster. ## Improvements to built-in authentication -It's now much easier to control access to your code on Sourcegraph. When using `auth.provider == "builtin"`, two new important changes mean that a Sourcegraph Server instance will be locked down and only accessible to users who are invited by an admin user (previously, we advised users to place their own auth proxy in front of Sourcegraph servers). +It's now much easier to control access to your code on Sourcegraph. When using `auth.provider == "builtin"`, two new important changes mean that a Sourcegraph instance will be locked down and only accessible to users who are invited by an admin user (previously, we advised users to place their own auth proxy in front of Sourcegraph servers). 1. When `auth.provider == "builtin"` is set, Sourcegraph will now by default require an admin to invite users instead of allowing any visitor to the site to sign up. Set `auth.allowSignup == true` to retain the old behavior of allowing anyone who can access the site to sign up. 2. When `auth.provider == "builtin"`, Sourcegraph now respects a new `auth.public` site configuration option (default value: `false`). When `auth.public == false`, Sourcegraph will not allow anyone to access the site unless they have an account and are signed in. ## Bitbucket Server support -We’ve added native integration for [Bitbucket Server](https://www.atlassian.com/software/bitbucket/server) so you can get powerful code search over all your Bitbucket Server projects in minutes. Click **Add Bitbucket Server repositories** in the site config area, fill in the generated fields, and select which repositories to enable. [See the documentation](/docs/server/config/repositories#bitbucket-server-configuration) for full instructions. +We’ve added native integration for [Bitbucket Server](https://www.atlassian.com/software/bitbucket/server) so you can get powerful code search over all your Bitbucket Server projects in minutes. Click **Add Bitbucket Server repositories** in the site config area, fill in the generated fields, and select which repositories to enable. [See the Bitbucket integration documentation](https://docs.sourcegraph.com/integration/bitbucket_server) for full instructions. -As always, in addition to natively supported code hosts (GitHub, GitLab, Gitolite etc.), repositories from any code host can be added with the [repos.list](/docs/server/config/repositories#sync-repositories-from-any-code-host) configuration option. +As always, in addition to natively supported code hosts (GitHub, GitLab, Gitolite etc.), Git repositories from any code host can be added. ## Better Phabricator integration We now display a **View on Phabricator** link rather than a **View on other code host** link if you are using Phabricator and hosting your code on GitHub or another code host with a UI. Commit links will now also point to Phabricator. -[Read the documentation](/docs/server/config/phabricator) to integrate Sourcegraph Server with Phabricator. - -## Safari extension (beta) +[Read the Phabricator integration documentation](https://docs.sourcegraph.com/integration/phabricator) to integrate Sourcegraph with Phabricator. -We’re bringing our browser extension for GitHub to Safari! Get code intelligence and code search on GitHub code files and PRs in Safari. The extension is currently in beta, but we invite our Safari users to try it out. [Download it now](/docs/features/safari-extension). -## Additional improvements: -* Slack notifications for saved searches may now be added for individual users (not just organizations). -* Added SSH cloning support to GitLab, GitHub, and GitHub Enterprise. -* Upgraded the JavaScript and TypeScript language server to use TypeScript 2.7. +## Changelog +See the [Sourcegraph changelog](https://sourcegraph.com/github.com/sourcegraph/sourcegraph/-/blob/CHANGELOG.md) for a list of all changes in this release. +--- -For a complete list of changes, see the [changelog](/changelog). - -Ready to install or upgrade? **[Install Sourcegraph Server 2.6](/docs/server)** +Ready to install or upgrade? **[Install Sourcegraph 2.6](https://docs.sourcegraph.com/#quickstart)** diff --git a/blogposts/liveblogging-github-universe.md b/blogposts/liveblogging-github-universe.md index f3d62ffccb8..cc0fc721d16 100644 --- a/blogposts/liveblogging-github-universe.md +++ b/blogposts/liveblogging-github-universe.md @@ -12,7 +12,7 @@ published: true -Hi, we’re Sourcegraph, the [code search engine](https://sourcegraph.com) for Go and Java that lets you [jump to def and find refs across all your code on GitHub](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack). You may remember us from such developer conference liveblogs as [Gophercon](http://gophercon.sourcegraph.com/archive), FOSDEM, and [dotGo](http://dotgo.sourcegraph.com/archive). +Hi, we’re Sourcegraph, the [code search engine](https://sourcegraph.com) for Go and Java that lets you [jump to def and find refs across all your code on GitHub](https://docs.sourcegraph.com/integration/browser_extension). You may remember us from such developer conference liveblogs as [Gophercon](http://gophercon.sourcegraph.com/archive), FOSDEM, and [dotGo](http://dotgo.sourcegraph.com/archive). This year, we’re excited to announce we’re liveblogging GitHub Universe! diff --git a/blogposts/more-control-over-your-teams-github-code-on-sourcegraph.md b/blogposts/more-control-over-your-teams-github-code-on-sourcegraph.md deleted file mode 100644 index 1d6b1b1b30f..00000000000 --- a/blogposts/more-control-over-your-teams-github-code-on-sourcegraph.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: "More control over your team's GitHub code on Sourcegraph" -author: 'Jamie Wilson' -publishDate: 2017-06-29T00:00-07:00 -tags: [ - "blog" -] -slug: more-control-over-your-teams-github-code-on-sourcegraph -heroImage: //images.ctfassets.net/le3mxztn6yoo/t4Qpcq5kA0AYM24Ws4mOk/4edf5502a936bbec90c262fa00355aed/sourcegraph-mark.png -published: true ---- - -**Update (January 2018)**: [Sourcegraph Server](/docs/server) is a free, self-hosted code search server that integrates with your code host and supports multi-repository, regexp, and diff searches. - -We've heard from many developers who want to use Sourcegraph to search and navigate their team's private code but who have only been able to use Sourcegraph on open source because of their company’s policies regarding GitHub authentication. - -Today we're happy to announce the solution to these concerns. Sourcegraph now supports [GitHub's new granular authorization model](https://developer.github.com/apps/), so you (or your team admin) can manage Sourcegraph for your whole team, grant read-only access to Sourcegraph, and choose which repositories will be accessible on Sourcegraph. - -## What this means for you: - -**If you're an engineering manager or admin and want to give your team access to Sourcegraph:** - -You’ll be able to authenticate only the repositories you need to—and without write access! And you can authenticate once on behalf of your entire team. To install Sourcegraph: - -- Visit [https://github.com/apps/sourcegraph](https://github.com/apps/sourcegraph) -- Click "Install" -- Select your organization -- Choose which repositories you want Sourcegraph to have access to -- Click "Install" - -Now every team member who signs up will automatically be able to use Sourcegraph on all of your organization’s repositories they can access (according to the permissions you’ve already set in GitHub). - -**If you are a developer who wants to use Sourcegraph to search and navigate your company's code:** - -It’s easier than before to get your organization’s GitHub admin to approve access. Just follow these steps: - -- [Sign into Sourcegraph](https://sourcegraph.com/login) (this does not require or ask for access to any code) -- Ask your org’s GitHub admin to view these instructions and follow the steps above (if they haven’t already done so) - -If you’ve previously authenticated private repositories, you’ll need to follow these steps again. - -And if you want to run Sourcegraph on your own network, get [Sourcegraph Server](https://about.sourcegraph.com/docs/server). - -Special thanks to GitHub for listening to our feedback and making these improvements so developers on many more teams can use Sourcegraph on their private code. diff --git a/blogposts/more-powerful-code-search-on-sourcegraph.md b/blogposts/more-powerful-code-search-on-sourcegraph.md index 77a3e2e4089..55f5f7e2eca 100644 --- a/blogposts/more-powerful-code-search-on-sourcegraph.md +++ b/blogposts/more-powerful-code-search-on-sourcegraph.md @@ -10,20 +10,17 @@ heroImage: //images.ctfassets.net/le3mxztn6yoo/38oAzef5facQ0eeGESkUCy/53de2ea851 published: true --- -
- -Today, we're releasing more powerful code search on Sourcegraph.com and Sourcegraph Server. You can use operators such as **repo:** and **file:** to restrict your search to certain repositories and files (by regular expression match on their name). +Today, we're releasing more powerful code search on Sourcegraph.com and Sourcegraph. You can use operators such as **repo:** and **file:** to restrict your search to certain repositories and files (by regular expression match on their name). For example, **repo:foo** will restrict your query to repositories whose name contains “foo,” and likewise for **file:bar**. -Search scopes make it easier to quickly search only among the code you care about, such as all JavaScript files or only non-vendored code. Custom search scopes are only available in -[Sourcegraph Server](/products/server/) right now, but we’ll let you define your own on Sourcegraph.com soon. +Search scopes make it easier to quickly search only among the code you care about, such as all JavaScript files or only non-vendored code.
-Try it out at [sourcegraph.com/search](https://sourcegraph.com/search) now. +Try it out at [sourcegraph.com/search](https://sourcegraph.com/search) or on a [self-hosted Sourcegraph instance](https://docs.sourcegraph.com/#quickstart) now. Use the search fields on the homepage to construct your query the first few times. @@ -33,8 +30,6 @@ As you continue using it, you can express your query more quickly by using the o * Search repositories named “mux” in test files for “new route”: [**repogroup:sample file:(test|spec) repo:mux new route**](https://sourcegraph.com/search?q=repo:mux+new+route&sq=repogroup:sample+file:%28test%7Cspec%29) * Search for occurrences of “partial<” in TypeScript files: [**repogroup:sample file:\.ts$ partial<**](https://sourcegraph.com/search?q=file:%5C.ts+partial%3C&sq=repogroup:sample) -Let us know what you think on Twitter ([@srcgraph](https://twitter.com/srcgraph)). To get advanced code search for your company’s code, [install Sourcegraph Server](/docs/server). +Let us know what you think on Twitter ([@srcgraph](https://twitter.com/srcgraph)). To get advanced code search for your company’s code, [install Sourcegraph](https://docs.sourcegraph.com). p.s. One other minor improvement: You can now select multiple lines (and share a link to multiple lines) by shift-clicking on a line number to expand the selection when you’re viewing a code file. - -
diff --git a/blogposts/part-2-how-sourcegraph-scales-with-the-language-server-protocol.md b/blogposts/part-2-how-sourcegraph-scales-with-the-language-server-protocol.md index be1e3b325a1..d63aaf1ac6e 100644 --- a/blogposts/part-2-how-sourcegraph-scales-with-the-language-server-protocol.md +++ b/blogposts/part-2-how-sourcegraph-scales-with-the-language-server-protocol.md @@ -28,7 +28,7 @@ Or, more pedantically, > **Code Intelligence** is the set of auto-navigation and auto-generation primitives that use a semantic understanding of code to enable a human programmer to efficiently read and write source code. > _(See the_ [_previous post_](https://text.sourcegraph.com/how-sourcegraph-scales-with-the-language-server-protocol-a4e8fd3fbae5) _for a breakdown of this definition.)_ -The Language Server Protocol was created by Microsoft to make Code Intelligence available for _every_ language in _every_ editor. Because Sourcegraph puts many of the abilities of editor plugins and IDEs into a browser-based app, LSP fits nicely into our technology stack. But Sourcegraph also differs from editors in some critical ways. Our goal is to make Code Intelligence available across [many](https://sourcegraph.com/github.com/gorilla/mux@94e7d24fd285520f3d12ae998f7fdd6b5393d453/-/blob/mux.go#L17:19-17:25) [different](https://sourcegraph.com/github.com/gorilla/mux@392c28fe23e1c45ddba891b0320b3b5df220beea/-/blob/mux.go#L17:19-17:25) [versions](https://sourcegraph.com/github.com/gorilla/mux@cafdb65e9ebf0275ed34de6b54f316e440a756bb/-/blob/mux.go#L17:19-17:25) [of](https://sourcegraph.com/github.com/gorilla/mux@b12896167c61cb7a17ee5f15c2ba0729d78793db/-/blob/mux.go#L17:19-17:25) [code](https://sourcegraph.com/github.com/gorilla/mux@293ebe14936bf5aa585139c72ea2f28d4164f984/-/blob/mux.go#L17:19-17:25) (note the different commit hashes in those links), in many different settings both inside and [outside your editor](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack), and across a global view of code rather than just the code on your dev machine. +The Language Server Protocol was created by Microsoft to make Code Intelligence available for _every_ language in _every_ editor. Because Sourcegraph puts many of the abilities of editor plugins and IDEs into a browser-based app, LSP fits nicely into our technology stack. But Sourcegraph also differs from editors in some critical ways. Our goal is to make Code Intelligence available across [many](https://sourcegraph.com/github.com/gorilla/mux@94e7d24fd285520f3d12ae998f7fdd6b5393d453/-/blob/mux.go#L17:19-17:25) [different](https://sourcegraph.com/github.com/gorilla/mux@392c28fe23e1c45ddba891b0320b3b5df220beea/-/blob/mux.go#L17:19-17:25) [versions](https://sourcegraph.com/github.com/gorilla/mux@cafdb65e9ebf0275ed34de6b54f316e440a756bb/-/blob/mux.go#L17:19-17:25) [of](https://sourcegraph.com/github.com/gorilla/mux@b12896167c61cb7a17ee5f15c2ba0729d78793db/-/blob/mux.go#L17:19-17:25) [code](https://sourcegraph.com/github.com/gorilla/mux@293ebe14936bf5aa585139c72ea2f28d4164f984/-/blob/mux.go#L17:19-17:25) (note the different commit hashes in those links), in many different settings both inside and [outside your editor](https://docs.sourcegraph.com/integration/browser_extension), and across a global view of code rather than just the code on your dev machine. [![](https://cdn-images-1.medium.com/max/800/1*t1ZtJ6Y5pxV-SbZ3_X0Imw.png)](https://sourcegraph.com/github.com/gorilla/mux@392c28fe23e1c45ddba891b0320b3b5df220beea/-/blob/mux.go#L17:19-17:25)Global usage examples, one of the advanced Code Intelligence features that only Sourcegraph provides. diff --git a/blogposts/poetically-simple-code-review.md b/blogposts/poetically-simple-code-review.md index 80e040e354a..e1291b0a778 100644 --- a/blogposts/poetically-simple-code-review.md +++ b/blogposts/poetically-simple-code-review.md @@ -12,9 +12,9 @@ published: true -_(Note: if you want to skip the poetry and just check out the project,_ [_click here_](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack)_)_ +_(Note: if you want to skip the poetry and just check out the project,_ [_click here_](https://docs.sourcegraph.com/integration/browser_extension)_)_ -Begin [code review](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack?hl=en). +Begin [code review](https://docs.sourcegraph.com/integration/browser_extension?hl=en). Too many lines, what to do? Hmm. LGTM? @@ -24,13 +24,13 @@ There’s a better way to review fast but ensure good code quality: -[![](https://cdn-images-1.medium.com/max/800/1*Zj9VrnJD7Tu05fj3tjom6w.png)](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack?hl=en) +[![](https://cdn-images-1.medium.com/max/800/1*Zj9VrnJD7Tu05fj3tjom6w.png)](https://docs.sourcegraph.com/integration/browser_extension?hl=en) One-click jump-to-def and hover over for docs. Save time and focus: -[![](https://cdn-images-1.medium.com/max/800/1*JJqFwhtYfXFypwV1G7zevA.png)](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack?hl=en) +[![](https://cdn-images-1.medium.com/max/800/1*JJqFwhtYfXFypwV1G7zevA.png)](https://docs.sourcegraph.com/integration/browser_extension?hl=en) Find refs globally. See where the code’s being used. @@ -54,13 +54,13 @@ in so many tabs. There’s a better way   — a Google Chrome extension. -[**Try it out today**](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack?hl=en). +[**Try it out today**](https://docs.sourcegraph.com/integration/browser_extension?hl=en). -[![](https://cdn-images-1.medium.com/max/800/1*adb7n4s1Z40lmUTek-hGPw.png)](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack?hl=en) +[![](https://cdn-images-1.medium.com/max/800/1*adb7n4s1Z40lmUTek-hGPw.png)](https://docs.sourcegraph.com/integration/browser_extension?hl=en) No more git cloning, no more grepping and moaning. -Just point, click, [**review**](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack?hl=en). +Just point, click, [**review**](https://docs.sourcegraph.com/integration/browser_extension?hl=en). (P.S. with Go support, and TypeScript and JavaScript in beta @@ -70,4 +70,4 @@ with Go support, and TypeScript and JavaScript in beta P.P.S. Each stanza of this post was a haiku. If you think there’s something poetic about good code and good code reviews, [follow us on Twitter](https://twitter.com/srcgraph) or check out [Sourcegraph](https://sourcegraph.com). -[![](https://cdn-images-1.medium.com/max/800/1*VUuHfrjTo93o7TreumQaRA.png)](https://chrome.google.com/webstore/detail/sourcegraph-for-github/dgjhfomjieaadpoljlnidmbgkdffpack?hl=en) +[![](https://cdn-images-1.medium.com/max/800/1*VUuHfrjTo93o7TreumQaRA.png)](https://docs.sourcegraph.com/integration/browser_extension?hl=en) diff --git a/blogposts/powerful-code-search-for-bitbucket-server.md b/blogposts/powerful-code-search-for-bitbucket-server.md index 314ece49df6..0848a1f4b4e 100644 --- a/blogposts/powerful-code-search-for-bitbucket-server.md +++ b/blogposts/powerful-code-search-for-bitbucket-server.md @@ -14,11 +14,11 @@ published: true
-Today, we're bringing fast, powerful code search to the thousands of development teams on Bitbucket Server. With Sourcegraph Server 2.6, we've built out native support for Bitbucket Server to make it easier to get code search across all your Bitbucket Server repositories. +Today, we're bringing fast, powerful code search to the thousands of development teams on Bitbucket Server. With Sourcegraph 2.6, we've built out native support for Bitbucket Server to make it easier to get code search across all your Bitbucket Server repositories. Follow these 4 steps to get code search for your Bitbucket Server code: -1. [Spin up a Sourcegraph Server instance](/docs/server) (or use the [Data Center deployment option](https://about.sourcegraph.com/docs/server/datacenter) on Kubernetes for massive scale) +1. [Spin up a Sourcegraph instance](https://docs.sourcegraph.com/admin) (or use the [cluster deployment option](https://docs.sourcegraph.com/admin/install/cluster) on Kubernetes for massive scale) 2. Click **Configuration** in the site admin menu. 3. Click **Add Bitbucket Server repositories** and fill in the fields in the generated `bitbucketServer` configuration option. @@ -29,6 +29,6 @@ Follow these 4 steps to get code search for your Bitbucket Server code: And that’s it--you're ready to start searching across your Bitbucket Server repositories! -For all configuration options for Bitbucket Server, see the documentation for the [bitbucketServer configuration option](/docs/server/config/repositories#bitbucket-server-configuration). +For all configuration options for Bitbucket Server, see the [Bitbucket Server integration documentation](https://docs.sourcegraph.com/integration/bitbucket_server). -[Sourcegraph Server](/docs/server) helps development teams build better software with code search and intelligence. It's free, self-hosted, and takes 5 minutes to set up. Read the [Sourcegraph Server 2.6 announcement blog post](/blog/introducing-sourcegraph-server-2-6) to see more new features from our latest release. +[Sourcegraph](https://docs.sourcegraph.com) helps development teams build better software with code search and intelligence. It's free, self-hosted, and takes 5 minutes to set up. Read the [Sourcegraph 2.6 announcement blog post](/blog/introducing-sourcegraph-server-2-6) to see more new features from our latest release. diff --git a/blogposts/regexp-queries-directories-openid-connect-and-more-updates-to-sourcegraph.md b/blogposts/regexp-queries-directories-openid-connect-and-more-updates-to-sourcegraph.md index 6f16fd7fbad..1fadb7eee2d 100644 --- a/blogposts/regexp-queries-directories-openid-connect-and-more-updates-to-sourcegraph.md +++ b/blogposts/regexp-queries-directories-openid-connect-and-more-updates-to-sourcegraph.md @@ -1,5 +1,5 @@ --- -title: 'Regexp queries, directories, OpenID Connect, and more updates to Sourcegraph Server' +title: 'Regexp queries, directories, OpenID Connect, and more updates to Sourcegraph' author: 'Quinn Slack' publishDate: 2017-11-13T00:00-08:00 tags: [ @@ -10,10 +10,8 @@ heroImage: //images.ctfassets.net/le3mxztn6yoo/t4Qpcq5kA0AYM24Ws4mOk/4edf5502a93 published: true --- -
- -We've been hard at work on improvements to [Sourcegraph Server](https://about.sourcegraph.com/products/server) to give you great code search on your company's code. Here's what's new and improved: +We've been hard at work on improvements to [Sourcegraph](https://docs.sourcegraph.com) to give you great code search on your company's code. Here's what's new and improved:
@@ -28,15 +26,15 @@ Code search: * Fixed the revision switcher for repositories with != 3 path components in their name. * Clicking on an item in the query suggestions menu now navigates to that item. Previously you needed to use the keyboard. * The ?q=&sq= URL params no longer follow you everywhere. -* Various bugs were fixed in the [editor integrations](https://about.sourcegraph.com/integrations/) for code search +* Various bugs were fixed in the [editor integrations](https://docs.sourcegraph.com/integration) for code search + +Self-hosted Sourcegraph instances: -Sourcegraph Server: -* SSO sign-in via OpenID Connect grants the user the same abilities as the native sign-in. Read the [installation documentation](https://about.sourcegraph.com/docs/server/install/#openid-connect) for configuration instructions. +* SSO sign-in via OpenID Connect grants the user the same abilities as the native sign-in. Read the [installation documentation](https://docs.sourcegraph.com/admin/auth) for configuration instructions. On Sourcegraph.com: -* The “All repositories” scope is now available. You still need to specify repo: and/or repogroup: filters to narrow the search to 30 or fewer repositories. (Example: `repo:github.com/myorg/myquery`). -You can install Sourcegraph Server with a single command at [https:about.sourcegraph.com/docs/server](/docs/server). +* The “All repositories” scope is now available. You still need to specify repo: and/or repogroup: filters to narrow the search to 30 or fewer repositories. (Example: `repo:github.com/myorg/myquery`). -
+Want to run a self-hosted instance of Sourcegraph with your own private code? [Install Sourcegraph with a single command.](https://docs.sourcegraph.com/#quickstart) diff --git a/blogposts/sourcegraph-2-10.md b/blogposts/sourcegraph-2-10.md index 6813ebb1856..fc8891c4941 100644 --- a/blogposts/sourcegraph-2-10.md +++ b/blogposts/sourcegraph-2-10.md @@ -18,13 +18,12 @@ This makes one of Sourcegraph's most-loved features—hover tooltips, go-to-defi - [Inline symbol typeahead on GitHub](#inline-symbol-typeahead-on-github) - [Experimental mermaid.js rendering on GitHub](#experimental-mermaidjs-rendering-on-github) - [Better repository syncing with your code host](#better-repository-syncing-with-code-hosts) -- [Other improvements and fixes](#full-changelog-from-29-to-210) -Ready to install or upgrade? [Get Sourcegraph for yourself (to get started)](/) or [deploy Sourcegraph for your team](/docs). +Ready to install or upgrade? [Get Sourcegraph 2.10.](https://docs.sourcegraph.com/#quickstart) ## Smoother tooltips everywhere -Last month we shipped [new, smoother tooltips on Sourcegraph](/blog/sourcegraph-2-9-announcement-code-search-user-rollout-in-large-organizations#improved-code-view-and-hover-tooltips). Now these are available in the [Sourcegraph integration](/docs/integrations) for your code host or code review tool, too (such as Sourcegraph for [Chrome](https://chrome.google.com/webstore/detail/sourcegraph/dgjhfomjieaadpoljlnidmbgkdffpack) or [Firefox](https://addons.mozilla.org/en-US/firefox/addon/sourcegraph/)). +Last month we shipped [new, smoother tooltips on Sourcegraph](/blog/sourcegraph-2-9-announcement-code-search-user-rollout-in-large-organizations#improved-code-view-and-hover-tooltips). Now these are available in the [Sourcegraph integration](https://docs.sourcegraph.com/integration) for your code host or code review tool, too (such as the [Sourcegraph browser extension](https://docs.sourcegraph.com/integration/browser_extension)). ![Screenshot from 2018-08-01 11-16-49](//images.ctfassets.net/le3mxztn6yoo/14pZiUUFXeSAeS4CAQ48IY/4630b6856f89cf846dfaf3549d39a4bb/Screenshot_from_2018-08-01_11-16-49.png) @@ -36,7 +35,7 @@ This unification means that we've now built a common platform that lets us build You now get ! symbol auto-complete in GitHub text boxes, just like GitHub's built-in autocomplete for # (issue/PR numbers and titles) and @ (names of users and organizations). This makes it easier to link to code when reviewing PRs or filing issues. -When typing an issue or PR comment on GitHub, just type ! in the text box and then the first few letters of a function, class, type, etc., in your repository. (You need to have [Sourcegraph for Chrome/Firefox](/docs/features/browser-extension) installed.) +When typing an issue or PR comment on GitHub, just type ! in the text box and then the first few letters of a function, class, type, etc., in your repository. (You need to have [Sourcegraph for Chrome/Firefox](https://docs.sourcegraph.com/integration/browser_extension) installed.) ![2018-07-31 12.56.02](//images.ctfassets.net/le3mxztn6yoo/5o7PyFNNKg0emcI6e8Q6cS/f073f5e6c594fd3fa98b8ca9a9206bbf/2018-07-31_12.56.02.gif) @@ -46,7 +45,7 @@ Architecture diagrams are incredibly useful when trying to understand a codebase Wouldn’t it be great if you could just specify a diagram directly in markdown, have it rendered nicely in your browser, and have it versioned alongside your code? Now you can! -With the latest [Sourcegraph for Chrome/Firefox](/docs/features/browser-extension), you can can add [mermaid.js](https://mermaidjs.github.io/) diagrams to your markdown files and they will be rendered when viewed on GitHub.com. [Read the instructions](https://github.com/sourcegraph/mermaidjs-example/blob/master/README.md) to get started. +With the latest [Sourcegraph for Chrome/Firefox](https://docs.sourcegraph.com/integration/browser_extension), you can can add [mermaid.js](https://mermaidjs.github.io/) diagrams to your markdown files and they will be rendered when viewed on GitHub.com. [Read the instructions](https://github.com/sourcegraph/mermaidjs-example/blob/master/README.md) to get started. ![mermaidjs](//images.ctfassets.net/le3mxztn6yoo/5k55EUL0CQiESGy8gwcyWS/29b17a9f25f9f92fc8f526186a771edd/mermaidjs.gif) @@ -58,44 +57,14 @@ Sourcegraph also now tries harder to stay under your code host's API rate limit, _If your instance shares an IP or netblock with another host that is abusing GitHub (which happens sometimes on public cloud providers), it's still possible to get temporarily blocked by GitHub. This should be rare, and you're now unlikely to even notice it (except that new repositories and updated repository metadata will not be available)._ -_If you've either [disabled repository updates](/docs/config/site/#disableautogitupdates-boolean) or [reduced the repository update interval](/docs/config/site/#repolistupdateinterval-integer) because they were affecting performance, try re-adjusting these settings and let us know how it works out._ - - -## Full changelog (from 2.9 to 2.10) - -- In the file tree, if a directory that contains only a single directory is expanded, its child directory is now expanded automatically. This is especially helpful for Java projects, which often have deeply nested directories. -- Fixed an issue where Sourcegraph Server would not start code intelligence containers properly when the Sourcegraph Server container was shut down non-gracefully. -- Fixed an issue where the file tree would return an error when navigating between repositories. -- Repo-updater has a new and improved scheduler for periodic repository fetches. If you have problems with it, you can revert to the old behavior by adding `"experimentalFeatures": { "updateScheduler": "disabled" }` to your `config.json`. -- A once-off migration will run changing the layout of cloned repos on disk. This should only affect installations created January 2018 or before. There should be no user visible changes. -- Experimental feature flag `experimentalFeatures.updateScheduler` enables a smarter and less spammy algorithm for automatic repository updates. -- It is no longer possible to disable code intelligence by unsetting the LSP_PROXY environment variable. Instead, code intelligence can be disabled per language on the site admin page (e.g. https://sourcegraph.example.com/site-admin/code-intelligence). -- Bitbucket API requests made by Sourcegraph are now under a self-enforced API rate limit (since Bitbucket Server does not have a concept of rate limiting yet). This will reduce any chance of Sourcegraph slowing down or causing trouble for Bitbucket Server instances connected to it. The limits are: 7,200 total requests/hr, with a bucket size / maximum burst size of 500 requests. -- Global, org, and user settings are now validated against the schema, so invalid settings will be shown in the settings editor with a red squiggly line. -- The `http-header` auth provider now supports being used with other auth providers (still only when `experimentalFeatures.multipleAuthProviders` is `true`). -- Periodic fetches of Gitolite-hosted repositories are now handled internally by repo-updater. -- The `log.sentry.dsn` field in the site config makes Sourcegraph log application errors to a Sentry instance. -- Two new repository page hotkeys were added: r to open the repositories menu and v to open the revision selector. -- Repositories are periodically (~45 days) recloned from the codehost. The codehost can be relied on to give an efficient packing. This is an alternative to running a memory and CPU intensive git gc and git prune. -- The `auth.sessionExpiry` field sets the session expiration age in seconds (defaults to 90 days). -- Fixed a bug in the API console that caused it to display as a blank page in some cases. -- Fixed cases where GitHub rate limit wasn't being respected. -- Fixed a bug where scrolling in references, history, etc. file panels was not possible in Firefox. -- Fixed cases where gitserver directory structure migration could fail/crash. -- Fixed "Generate access token" link on user settings page. Previously, this link would 404. -- Fixed a bug where the search query was not updated in the search bar when searching from the homepage. -- Fixed a possible crash in github-proxy. -- `SOURCEGRAPH_CONFIG` environment variable has been removed. Site configuration is always read from and written to disk. You can configure the location by providing `SOURCEGRAPH_CONFIG_FILE`. The default path is `/etc/sourcegraph/config.json`. -- The search results page will merge duplicated lines of context. -- The following deprecated site configuration properties have been removed: `github[].preemptivelyClone`, `gitOriginMap`, `phabricatorURL`, `githubPersonalAccessToken`, `githubEnterpriseURL`, `githubEnterpriseCert`, and `githubEnterpriseAccessToken`. (All have been superseded for 6 months by other properties.) -- The `settings` field in the site config file is deprecated and will not be supported in a future release. Site admins should move those settings (if any) to global settings (in the site admin UI). Global settings are preferred to site config file settings because the former can be applied without needing to restart/redeploy the Sourcegraph server or cluster. -- Fixed a goroutine leak which occurs when search requests are canceled. -- Console output should have fewer spurious line breaks. -- Fixed an issue where it was not possible to override the `StrictHostKeyChecking` SSH option in the SSH configuration. -- Fixed an issue where saving an organization's configuration would hang indefinitely. +_If you've either [disabled repository updates]https://docs.sourcegraph.com/admin/site_config/all/#disableautogitupdates-boolean) or [reduced the repository update interval]https://docs.sourcegraph.com/admin/site_config/all/#repolistupdateinterval-integer) because they were affecting performance, try re-adjusting these settings and let us know how it works out._ + +## Changelog + +See the [Sourcegraph changelog](https://sourcegraph.com/github.com/sourcegraph/sourcegraph/-/blob/CHANGELOG.md) for a list of all changes in this release. --- -**Ready to install or upgrade? [Get Sourcegraph for yourself (to get started)](/) or [deploy Sourcegraph for your team](/docs).** +Ready to install or upgrade? [Get Sourcegraph 2.10.](https://docs.sourcegraph.com/#quickstart) -Questions/feedback/complaints/requests? Contact us at [@srcgraph](https://twitter.com/srcgraph) or , or file issues on our [public issue tracker](https://github.com/sourcegraph/issues/issues). We're planning for our next release in August right now, so the sooner we hear from you, the better! +Questions/feedback/complaints/requests? Contact us at [@srcgraph](https://twitter.com/srcgraph) or , or file issues on our [public issue tracker](https://github.com/sourcegraph/sourcegraph/issues). We're planning for our next release in August right now, so the sooner we hear from you, the better! diff --git a/blogposts/sourcegraph-2-11-release-notes.md b/blogposts/sourcegraph-2-11-release-notes.md index 09297187101..754d777023d 100644 --- a/blogposts/sourcegraph-2-11-release-notes.md +++ b/blogposts/sourcegraph-2-11-release-notes.md @@ -14,41 +14,39 @@ Our mission is to build [the best code search and browsing tool for your team](/ Here’s new, what’s changed, and what’s fixed. -- [Simplified Browser Extension Configuration](#simplified-browser-extension-configuration) +- [Simplified browser extension configuration](#simplified-browser-extension-configuration) -- [Deploy Sourcegraph Data Center to Kubernetes with Plain YAML](#deploy-sourcegraph-data-center-to-kubernetes-with-plain-yaml) +- [Deploy Sourcegraph to Kubernetes with plain YAML](#deploy-sourcegraph-to-kubernetes-with-plain-yaml) -- [Webhooks for Manual Repository Updates](#webhooks-for-manual-repository-updates) +- [Webhooks for manual repository updates](#webhooks-for-manual-repository-updates) -- [Sourcegraph Extensions (Alpha): Show Info from Other Tools in Code and Reviews](#sourcegraph-extensions-alpha-show-info-from-other-tools-in-code-and-reviews) +- [Sourcegraph extensions (alpha): Show info from other tools in code and reviews](#sourcegraph-extensions-alpha-show-info-from-other-tools-in-code-and-reviews) -- [Full Changelog (from 2.10 to 2.11)](#full-changelog-from-210-to-211) +Ready to install or upgrade? [Get Sourcegraph 2.11.](https://docs.sourcegraph.com/#quickstart) -Ready to install or upgrade? [Get Sourcegraph for yourself (to get started)](/) or [deploy Sourcegraph for your team](/docs). - -## Simplified Browser Extension Configuration +## Simplified browser extension configuration The browser extension used to require manual configuration when being used with a private Sourcegraph server. With the latest release, the browser extension now only needs the URL for the Sourcegraph server it’s pointing to. ![Simplified Browser Extension Configuration](//images.ctfassets.net/le3mxztn6yoo/1UabqJXkpyKU4QSa0KWoiM/19954ac186f24b0a0ae20bb0b3199c43/BrowserConfiguration.gif) -This feature also shows off the new Sourcegraph settings page for the extension, which you can get to by clicking the Sourcegraph icon in the browser toolbar. More details in [Sourcegraph integrations documentation](/docs/integrations/). +This feature also shows off the new Sourcegraph settings page for the extension, which you can get to by clicking the Sourcegraph icon in the browser toolbar. More details in [Sourcegraph browser extension documentation](https://docs.sourcegraph.com/integration/browser_extension). -## Deploy Sourcegraph Data Center to Kubernetes with Plain YAML +## Deploy Sourcegraph to Kubernetes with plain YAML We have simplified the process for deploying Sourcegraph to Kubernetes by eliminating Helm as a dependency, eliminating our custom monolithic config file, and eliminating Go templates in favor of using pure Kubernetes YAML. This reduces the complexity of the Sourcegraph Kubernetes deployment and makes it easier for customers to manage their own customizations. We appreciate your patience as we have changed the Kubernetes deployment process over the last few months. The outcome is a much simpler deployment process that doesn't require external tools for deployment or YAML generation. -Existing customers can read the [migration guide](https://github.com/sourcegraph/deploy-sourcegraph/blob/master/docs/migrate.md) for more information. +Existing customers can read the [deploy-sourcegraph documentation](https://github.com/sourcegraph/deploy-sourcegraph) for more information. -## Webhooks for Manual Repository Updates +## Webhooks for manual repository updates By default, Sourcegraph polls code hosts to keep repository contents up to date. It uses intelligent heuristics such as average update frequency to determine the polling frequency per repository. Polling, however, falls short in cases where immediate updates are desired or when the number of repositories causes significant load on the code host. To address this, there is now a repository update webhook that lets an external service (such as a code host) trigger a repository update on Sourcegraph. The webhook is authenticated using access tokens. -[See webhook docs](/docs/config/update-repo-webhook) for more information. +[See webhook docs](https://docs.sourcegraph.com/admin/repo/webhooks) for more information. -## Sourcegraph Extensions (Alpha): Show Info from Other Tools in Code and Reviews +## Sourcegraph extensions (alpha): Show info from other tools in code and reviews We're also excited to announce the alpha release of [Sourcegraph extensions](https://docs.sourcegraph.com/extensions), a new way to enhance viewing and reviewing code in all of your favorite tools, starting with [Codecov](https://codecov.io) test coverage overlays on GitHub and Sourcegraph. @@ -58,30 +56,10 @@ Here's what the Codecov extension for Sourcegraph looks like, running on GitHub ![Codecov Extension](//images.ctfassets.net/le3mxztn6yoo/3WZ3oy1haU4YeYWywuS0Qe/a25491260dd59fb4028e6bcea6c4c88a/CodeCovExtension.gif) -## Full Changelog (from 2.10 to 2.11) - -### Added -- Support for ACME `tls-alpn-01` challenges to obtain Let's Encrypt certificates. Previously Sourcegraph only supported ACME `http-01` challenges, which required port 80 to be accessible. -- gitserver periodically removes stale lock files that git can leave behind. -- Clients (browser/editor extensions) can now query configuration details from the `ClientConfiguration` GraphQL API. -- The config field `auth.accessTokens.allow` allows or restricts use of access tokens. It can be set to one of three values: "all-users-create" (the default), "none" (all access tokens are disabled), and "site-admin-create" (access tokens are enabled, but only site admins can create new access tokens). The field `auth.disableAccessTokens` is now deprecated in favor of this new field. -- A webhook endpoint now exists to trigger repository updates. For example, `curl -XPOST -H 'Authorization: token $ACCESS_TOKEN' $SOURCEGRAPH_ORIGIN/.api/repos/$REPO_URI/-/refresh`. -- Git submodules entries in the file tree now link to the submodule repository. - -### Fixed -- An issue / edge case where the code intelligence management admin page would incorrectly show language servers as `Running` when they had been removed from Docker. -- Log level is respected in lsp-proxy logs. -- Fixed an error where text searches could be routed to a faulty search worker. -- Gitolite integration should correctly detect names which Gitolite would consider to be patterns, and not treat them as repositories. -- repo-updater backs off fetches on a repo that's failing to fetch. -- Attempts to add a repo with an empty string for the name are checked for and ignored. -- Fixed an issue where non-site-admin authenticated users could modify global settings (not site configuration), other organizations' settings, and other users' settings. -- Search results are rendered more eagerly, resulting in fewer blank file previews -- Fixed an issue where automatic code intelligence would fail to connect to the underlying `lsp` network, leading to `dial tcp: lookup lang on 0.0.0.0:53: no such host` errors. -- Commits with empty trees no longer return 404. -- More useful error messages from lsp-proxy when a language server can't get a requested revision of a repository. -- Creation of a new user with the same name as an existing organization (and vice versa) is prevented. +## Changelog + +See the [Sourcegraph changelog](https://sourcegraph.com/github.com/sourcegraph/sourcegraph/-/blob/CHANGELOG.md) for a list of all changes in this release. --- -Questions/feedback/complaints/requests? Contact us at [support@sourcegraph.com](mailto:support@sourcegraph.com), or file issues on our [public issue tracker](https://github.com/sourcegraph/issues/issues). We're planning for our next release in October right now, so the sooner we hear from you, the better! +Questions/feedback/complaints/requests? Contact us at [support@sourcegraph.com](mailto:support@sourcegraph.com), or file issues on our [public issue tracker](https://github.com/sourcegraph/sourcegraph/issues). We're planning for our next release in October right now, so the sooner we hear from you, the better! diff --git a/blogposts/sourcegraph-2-12-release-notes.md b/blogposts/sourcegraph-2-12-release-notes.md index ab23265a142..73b15ff2f50 100644 --- a/blogposts/sourcegraph-2-12-release-notes.md +++ b/blogposts/sourcegraph-2-12-release-notes.md @@ -26,44 +26,11 @@ Here’s new, what’s changed, and what’s fixed in Sourcegraph 2.12. - [New product packaging and pricing](/blog/pricing-and-package-changes) -- [Full changelog (from 2.11 to 2.12)](#full-changelog-from-211-to-212) - -Ready to install or upgrade? [Get Sourcegraph for yourself (to get started)](/) or [deploy Sourcegraph for your team](/docs). - -## Full changelog (from 2.11 to 2.12) - -### Changed - -- Reduced the size of in-memory data structures used for storing search results. This should reduce the backend memory usage of large result sets. -- Code intelligence is now provided by [Sourcegraph extensions](https://docs.sourcegraph.com/extensions). The extension for each language in the site configuration `langservers` property is automatically enabled. -- Support for multiple authentication providers is now enabled by default. To disable it, set the `experimentalFeatures.multipleAuthProviders` site config option to `"disabled"`. This only applies to Sourcegraph Enterprise. -- When using the `http-header` auth provider, valid auth cookies (from other auth providers that are currently configured or were previously configured) are now respected and will be used for authentication. These auth cookies also take precedence over the `http-header` auth. Previously, the `http-header` auth took precedence. -- Bitbucket Server username configuration is now used to clone repositories if the Bitbucket Server API does not set a username. -- Code discussions: On Sourcegraph.com / when `discussions.abuseProtection` is enabled in the site config, rate limits to thread creation, comment creation, and @mentions are now applied. - -### Added - -- Search syntax for filtering archived repositories. `archived:no` will exclude archived repositories from search results, `archived:only` will search over archived repositories only. This applies for GitHub and GitLab repositories. -- A Bitbucket Server option to exclude personal repositories in the event that you decide to give an admin-level Bitbucket access token to Sourcegraph and do not want to create a bot account. See https://about.sourcegraph.com/docs/config/repositories/#excluding-personal-repositories for more information. -- Site admins can now see when users of their Sourcegraph instance last used it via a code host integration (e.g. Sourcegraph browser extensions). Visit the site admin Analytics page (e.g. https://sourcegraph.example.com/site-admin/analytics) to view this information. -- A new site config option `extensions.allowRemoteExtensions` lets you explicitly specify the remote extensions (from, e.g., Sourcegraph.com) that are allowed. -- Pings now include a total count of user accounts. -- A new site config option `git.cloneURLToRepositoryName` specifies manual mapping from Git clone URLs to Sourcegraph repository names. This is useful, for example, for Git submodules that have local clone URLs. - -### Fixed - -- Files with the gitattribute `export-ignore` are no longer excluded for language analysis and search. -- "Discard changes?" confirmation popup doesn't pop up every single time you try to navigate to a new page after editting something in the site settings page anymore. -- Fixed an issue where Git repository URLs would sometimes be logged, potentially containing e.g. basic auth tokens. -- Fixed date formatting on the site admin Analytics page. -- File names of binary and large files are included in search results. -- Slack notifications for saved searches have been fixed. - -### Removed - -- The deprecated environment variables `SRC_SESSION_STORE_REDIS` and `REDIS_MASTER_ENDPOINT` are no longer used to configure alternative redis endpoints. For more information view the [External database](https://about.sourcegraph.com/docs/config/external-database) documentation. +Ready to install or upgrade? [Get Sourcegraph 2.12.](https://docs.sourcegraph.com/#quickstart) +## Changelog +See the [Sourcegraph changelog](https://sourcegraph.com/github.com/sourcegraph/sourcegraph/-/blob/CHANGELOG.md) for a list of all changes in this release. --- diff --git a/blogposts/sourcegraph-2-8-19-languages-ridiculously-huge-monorepos-lsp-a-graphql-api.md b/blogposts/sourcegraph-2-8-19-languages-ridiculously-huge-monorepos-lsp-a-graphql-api.md index 6dd75c384ce..91979846cad 100644 --- a/blogposts/sourcegraph-2-8-19-languages-ridiculously-huge-monorepos-lsp-a-graphql-api.md +++ b/blogposts/sourcegraph-2-8-19-languages-ridiculously-huge-monorepos-lsp-a-graphql-api.md @@ -26,44 +26,13 @@ New in Sourcegraph 2.8: - [Server pings](#server-pings) - [Misc.](#misc) -**Ready to install or upgrade? [Get Sourcegraph 2.8.](/)** +**Ready to install or upgrade? [Get Sourcegraph 2.8.](https://docs.sourcegraph.com/#quickstart)** ## Code intelligence for 13 more languages, via LSP -With code intelligence on Sourcegraph, you can navigate code more easily with hovers, -definitions, references, implementations, etc. It's all powered by language servers based on the [Language Server Protocol (LSP)](http://langserver.org) standard. +With code intelligence on Sourcegraph, you can navigate code more easily with hovers, definitions, references, implementations, etc. -Sourcegraph 2.8 ships with support for 13 more languages (in addition to the 6 languages already supported), thanks to the amazing contributions of hundreds of developers in the LSP ecosystem. In this release, you can also [connect any other LSP-compliant language server](/docs/code-intelligence/adapting-language-servers) to Sourcegraph. - -This brings the full list of languages with code intelligence on Sourcegraph to 19: - -* [Go](/docs/code-intelligence/go) -* [JavaScript](/docs/code-intelligence/javascript) -* [TypeScript](/docs/code-intelligence/typescript) -* [Python](/docs/code-intelligence/python) -* [Java](/docs/code-intelligence/java) -* [PHP](/docs/code-intelligence/php) -* [Bash](/docs/code-intelligence/experimental-language-servers) (experimental) -* [Clojure](/docs/code-intelligence/experimental-language-servers) (experimental) -* [C++](/docs/code-intelligence/experimental-language-servers) (experimental) -* [C#](/docs/code-intelligence/experimental-language-servers) (experimental) -* [CSS](/docs/code-intelligence/experimental-language-servers) (experimental) -* [Dockerfile](/docs/code-intelligence/experimental-language-servers) (experimental) -* [Elixir](/docs/code-intelligence/experimental-language-servers) (experimental) -* [HTML](/docs/code-intelligence/experimental-language-servers) (experimental) -* [Lua](/docs/code-intelligence/experimental-language-servers) (experimental) -* [OCaml](/docs/code-intelligence/experimental-language-servers) (experimental) -* [R](/docs/code-intelligence/experimental-language-servers) (experimental) -* [Ruby](/docs/code-intelligence/experimental-language-servers) (experimental) -* [Rust](/docs/code-intelligence/experimental-language-servers) (experimental) - -To get code intelligence for these new languages, see "[Experimental language servers](/docs/code-intelligence/experimental-language-servers)". Of course, once you've set them up on your organization's Sourcegraph instance, you'll also get code intelligence in all the Sourcegraph integrations you're using, such as GitHub, Phabricator, etc. - -For more information, see today's announcement "[Code intelligence for 13 more languages, with first-class LSP support](/blog/code-intelligence-for-more-languages-and-lsp-language-server-protocol-support)". - -Here's a GIF of the experimental new C# support: - - +**Update:** Sourcegraph now uses [Sourcegraph extensions](https://docs.sourcegraph.com/extensions) for language support. This section has been edited to avoid confusion. ## Perf improvements for massive monorepos @@ -75,13 +44,13 @@ Our test monorepo is too large for GitHub.com, but you can try the perf improvem ## Sourcegraph API -Sourcegraph's API is ready for you to start building on. Here are some examples of things you can do with the Sourcegraph API on your organization's own Sourcegraph instance: +Sourcegraph's GraphQL API is ready for you to start building on. Here are some examples of things you can do with the Sourcegraph API on your organization's own Sourcegraph instance: - [See the most-used programming languages in all of your organization's active repositories](https://sourcegraph.com/api/console#%7B%22query%22%3A%22%7B%5Cn%20%20repositories(enabled%3A%20true%2C%20query%3A%5C%22github.com%2Fsourcegraph%2F%5C%22)%20%7B%5Cn%20%20%20%20nodes%20%7B%5Cn%20%20%20%20%20%20name%5Cn%20%20%20%20%20%20language%5Cn%20%20%20%20%7D%5Cn%20%20%7D%5Cn%7D%5Cn%22%7D) - List all repositories without a Dockerfile, .travis.yml, LICENSE, README, etc. - Find all repositories that call a specific function or depend on a specific package -See [interactive Sourcegraph API examples](/docs/features/api/examples) for more inspiration. +See [Sourcegraph GraphQL API examples](https://docs.sourcegraph.com/api/graphql/examples) for more inspiration. The API exposes all of the data that Sourcegraph itself uses, such as: @@ -92,9 +61,9 @@ The API exposes all of the data that Sourcegraph itself uses, such as: Sourcegraph uses this API for everything, so the API is just as powerful, fast, and reliable as the Sourcegraph itself. You can play around with it on the [GraphQL console](https://sourcegraph.com/api/console) on on Sourcegraph.com or your own instance. Two other new features shipping today also help you use the API: the [Sourcegraph CLI](https://github.com/sourcegraph/src-cli) tool and [access tokens](#access-token-improvements). -One surprising thing we learned from customers is that never worrying about API rate limits is just as exciting as the new kinds of data exposed by the Sourcegraph API. We put tons of work into making Sourcegraph search, code intelligence, and mirrored Git data access super fast for interactive users--and that means you can write API clients that hit your Sourcegraph instance way harder than you could hit any code host. If needed, get [Sourcegraph Data Center](/docs/datacenter) for massive scale. +One surprising thing we learned from customers is that never worrying about API rate limits is just as exciting as the new kinds of data exposed by the Sourcegraph API. We put tons of work into making Sourcegraph search, code intelligence, and mirrored Git data access super fast for interactive users--and that means you can write API clients that hit your Sourcegraph instance way harder than you could hit any code host. If needed, get [Sourcegraph cluster deployment option](https://docs.sourcegraph.com/admin/install/cluster) for massive scale. -Check out the new [Sourcegraph API documentation](/docs/features/api) to get started. Not sure how to do something using the API? Post in our [public issue tracker](https://github.com/sourcegraph/issues). +Check out the new [Sourcegraph GraphQL API documentation](https://docs.sourcegraph.com/api/graphql) to get started. Not sure how to do something using the API? Post in our [public issue tracker](https://github.com/sourcegraph/sourcegraph). ## Improved Phabricator integration for code intelligence in diffs @@ -107,31 +76,31 @@ Code intelligence is most powerful when it's available in your code review tool. ![phabricator-extension-differential](//images.ctfassets.net/le3mxztn6yoo/5SXiFECe7SkKCIyeeoUGYe/959884db905b3f5ede1b14790d4ae346/phabricator-extension-differential.png) -[Install the Sourcegraph extension for Phabricator.](https://github.com/sourcegraph/phabricator-extension) Want support for another code host or code review tool (other than GitHub, which is also supported)? File an issue in our [public issue tracker](https://github.com/sourcegraph/issues/issues). +[Install the Sourcegraph extension for Phabricator.](https://github.com/sourcegraph/phabricator-extension) Want support for another code host or code review tool (other than GitHub, which is also supported)? File an issue in our [public issue tracker](https://github.com/sourcegraph/sourcegraph/issues). ## User authentication providers: easier, more configurable ways for users to sign into Sourcegraph We've improved Sourcegraph's support for user authentication providers, which allow users to sign into Sourcegraph using their existing accounts in your organization's SSO/directory service. Support is included for SAML, OpenID Connect (including G Suite for Google accounts), and HTTP authentication proxies. - The new site configuration property `auth.providers` defines the list of authentication providers in one place (instead of having authentication configuration scattered among `auth.provider` and other `auth.*` properties). Backcompat for the old (now-deprecated) `auth.provider` configuration is maintained. -- All authentication provider configuration changes are reflected immediately (in Sourcegraph Server) without the need for a restart. +- All authentication provider configuration changes are reflected immediately (in Sourcegraph) without the need for a restart. - Error messages describing authentication configuration problems are much better, both for end users and for site admins. - Improved user authentication provider documentation with clear steps for multiple commonly used services (Okta, OneLogin, G Suite, etc.). - Single-logout and token revocation are supported for OpenID Connect and SAML, so users can sign out of both Sourcegraph and the authentication provider. - Site admins can see who has signed into Sourcegraph via an authentication provider and inspect auth/account details for troubleshooting. -See [user authentication provider documentation](/docs/config/authentication) for setup instructions. Need support for other authentication providers or other configuration points? File an issue in our [public issue tracker](https://github.com/sourcegraph/issues/issues). +See [user authentication provider documentation](https://docs.sourcegraph.com/admin/auth) for setup instructions. Need support for other authentication providers or other configuration points? File an issue in our [public issue tracker](https://github.com/sourcegraph/sourcegraph/issues). ## Access token improvements This release improves support for access tokens, which enable access to the Sourcegraph API by external tools and scripts. -- Access tokens now work with [external user authentication providers](/docs/config/authentication) (OpenID Connect, SAML, and HTTP authentication proxies). -- A new [`site-admin:sudo` scope for access tokens](/docs/features/api#sudo-access-tokens) (which only site admins may use) lets the holder impersonate other users. This lays the foundation for future releases to integrate more closely with external tools in a seamless and authorization-aware manner. Stay tuned! +- Access tokens now work with [external user authentication providers](https://docs.sourcegraph.com/admin/auth) (OpenID Connect, SAML, and HTTP authentication proxies). +- A new [`site-admin:sudo` scope for access tokens](https://docs.sourcegraph.com/api/graphql#sudo-access-tokens) (which only site admins may use) lets the holder impersonate other users. This lays the foundation for future releases to integrate more closely with external tools in a seamless and authorization-aware manner. Stay tuned! - Site admins can now view all access tokens (created by any user) and revoke any access token. - The owner of an access token (and site admins) can now see when it was last used, to make it easier to prune unused tokens. -Along with the [Sourcegraph API improvements](#sourcegraph-api) in this release, we're working hard to let you build new kinds of tools on Sourcegraph to speed up and automate your team's work. +Along with the [Sourcegraph GraphQL API improvements](#sourcegraph-api) in this release, we're working hard to let you build new kinds of tools on Sourcegraph to speed up and automate your team's work.