Skip to content

Commit

Permalink
fix many broken links and outdated posts/sections (#72)
Browse files Browse the repository at this point in the history 
Helps with sourcegraph/sourcegraph#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
  • Loading branch information
@sqs
sqs authored Jan 3, 2019
1 parent 179e43b commit f1feab2
Show file tree
Hide file tree
Showing 57 changed files with 282 additions and 1,648 deletions.
2 changes: 1 addition & 1 deletion STYLEGUIDE.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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 <mailto:[email protected]>, 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 <mailto:[email protected]>, 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.

Expand Down
55 changes: 19 additions & 36 deletions blogposts/announcing-sourcegraph-2.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<div class="flex flex-column flex-row-l justify-between pv4-l">
<div class="flex-grow-1 order-1-l pl3-l pl0">
<img class="br2" src="https://images.contentful.com/le3mxztn6yoo/4JC9PXHpviy2Om2AKa6Ime/4de7c31950910afb02e7a4929b2497cb/code-comments.gif">
</div>
<div class="flex-grow-1 pr3-l pr0">
<h1 class="mt0 mb1">Introducing Sourcegraph Editor</h1>
<p>
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).
</p>
<a href="/products/editor"><span class="dib dim link mr3 pv2 ph3 f5 br2 ba b--grape-5 grape-7">Request early access</span></a>
</div>
</div>

<div class="flex flex-column flex-row-l pt3 justify-between pv4">
<div class="flex-grow-1 pr3-l pr0">
<img class="br2" src="https://images.contentful.com/le3mxztn6yoo/3GsCxhHwe40OsAOkkgoc0I/fe344150647340daffef37197bf2f638/server.gif">
</div>
<div class="flex-grow-1 pl3-l pl0">
<h1 class="mt0 mb1">Introducing Sourcegraph Server</h1>
<p>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.</p>
<p>Sourcegraph Server is what powers <a href="https://sourcegraph.com/sign-in">Sourcegraph.com</a>, and now you can run it inside your company's network.</p>
<a href="/products/server"><span class="dib dim link mr3 pv2 ph3 f5 br2 ba b--grape-5 grape-7">Request a demo</span></a>
</div>
</div>



<h1 class="mt0 mb1">Explore open-source code with the new Sourcegraph.com and browser extensions</h1>
Search and browse open-source code on <a href="https://sourcegraph.com/sign-in">Sourcegraph.com</a> 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 <a href="https://sourcegraph.com/">Sourcegraph.com</a>, 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 <a href="https://sourcegraph.com/">Sourcegraph.com</a> 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

<h1 class="mt0 mb1">Use Sourcegraph at work</h1>
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.

---

<a href="/products/editor"><span class="dib dim link mr3 pv2 ph3 f5 br2 ba b--grape-5 grape-7 mb2 mb0-l">Request early access to Sourcegraph Editor</span></a>
<a href="/products/server"><span class="dib dim link mr3 pv2 ph3 f5 br2 ba b--grape-5 grape-7">Request a demo of Sourcegraph Server</span></a>
[Install a self-hosted Sourcegraph instance in 1 command.](https://docs.sourcegraph.com/#quickstart)
11 changes: 7 additions & 4 deletions blogposts/announcing_sourcegraph_2.13.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand All @@ -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:
Expand All @@ -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.
8 changes: 4 additions & 4 deletions ...e-review-code-on-github-like-in-an-ide-with-the-sourcegraph-chrome-extension.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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)_!_

<iframe width="640" height="480" src="https://www.youtube.com/embed/hIs4QtuM1Ig" frameborder="0" allowfullscreen></iframe>

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.
Expand All @@ -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._

Expand Down
2 changes: 1 addition & 1 deletion blogposts/code-intelligence-for-java-now-available-on-sourcegraph.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
63 changes: 2 additions & 61 deletions ...ode-intelligence-for-more-languages-and-lsp-language-server-protocol-support.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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:

<img src="https://cl.ly/2R1f0D2e1I1w/csharp.gif" />

## 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.
4 changes: 2 additions & 2 deletions blogposts/code-intelligence-now-available-for-java-on-sourcegraph-com.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Loading

0 comments on commit f1feab2

Please sign in to comment.