From 7d05aa82bd3373e122b3e5687be3f8240daae035 Mon Sep 17 00:00:00 2001 From: Beyang Liu Date: Tue, 22 May 2018 12:41:45 -0700 Subject: [PATCH] sync over docs --- docs/install.md | 2 +- docs/scale.md | 20 +++++++++++--------- docs/troubleshoot.md | 4 +++- 3 files changed, 15 insertions(+), 11 deletions(-) diff --git a/docs/install.md b/docs/install.md index d1ae3bbd7df7..cc3caa828f3d 100644 --- a/docs/install.md +++ b/docs/install.md @@ -137,7 +137,7 @@ is defined by the `values.yaml` file in *this* directory. The structure of `values.yaml` is split into two top-level fields: - `site` defines application-level settings like code host integrations and authentication settings. The full set of - options for `site` is described here: https://about.sourcegraph.com/docs/config/settings. + options for `site` is described here: https://about.sourcegraph.com/docs/config/site. - `cluster` defines settings specific to the configuration of the Kubernetes cluster, like replica counts and CPU/memory allocation. Refer to the `values.yaml` in this repository to see which `cluster` fields can be overridden. diff --git a/docs/scale.md b/docs/scale.md index fa0a9398fabb..b88691db6f71 100644 --- a/docs/scale.md +++ b/docs/scale.md @@ -4,8 +4,8 @@ Sourcegraph Data Center can be configured to scale to very large codebases and l users. If you notice latency for search or code intelligence is higher than desired, changing these parameters can yield a drastic improvement in performance. -> For assistance scaling and tuning Sourcegraph, contact us -> at . We're happy to help! +> For assistance scaling and tuning +> Sourcegraph, [contact us](https://about.sourcegraph.com/contact/). We're happy to help! ## Tuning replica counts for horizontal scalability @@ -36,8 +36,8 @@ table. See the following sections for how to modify your `values.yaml` file to a | 200-1k | 5-10 | | 1k-5k | 10-15 | | 5k-25k | 20-40 | -| 25k+ | 40+ (contact us for scaling advice) | -| Monorepo | 1-25 (contact us for scaling advice) | +| 25k+ | 40+ ([contact us](https://about.sourcegraph.com/contact/) for scaling advice) | +| Monorepo | 1-25 ([contact us](https://about.sourcegraph.com/contact/) for scaling advice) |
@@ -48,8 +48,8 @@ table. See the following sections for how to modify your `values.yaml` file to a | 500-1000 | 3 | | 1k-5k | 4-8 | | 5k-25k | 8-20 | -| 25k+ | 20+ (contact us for scaling advice) | -| Monorepo | 1 (contact us for scaling advice) | +| 25k+ | 20+ ([contact us](https://about.sourcegraph.com/contact/) for scaling advice) | +| Monorepo | 1 ([contact us](https://about.sourcegraph.com/contact/) for scaling advice) | @@ -100,9 +100,11 @@ Notes: sourcegraph N` (where `N` is the previous version number as reported by `helm history sourcegraph`). Then run `kubectl delete deployment indexed-search && kubectl delete pvc indexed-search` and `helm upgrade sourcegraph ./helm-chart` again. -* If your change requires `gitserver` pods to be restarted and they are scheduled on another node when they restart, - they may go offline for 60-90 seconds (and temporarily show a `Multi-Attach` error). This delay is caused by Kubernetes - detaching and reattaching the volume. Mitigation steps depend on your cloud provider; contact us for advice. +* If your change requires `gitserver` pods to be restarted and they are scheduled on another node + when they restart, they may go offline for 60-90 seconds (and temporarily show a `Multi-Attach` + error). This delay is caused by Kubernetes detaching and reattaching the volume. Mitigation + steps depend on your cloud provider; [contact us](https://about.sourcegraph.com/contact/) for + advice. --- diff --git a/docs/troubleshoot.md b/docs/troubleshoot.md index df8e400f4d44..2e9480e42839 100644 --- a/docs/troubleshoot.md +++ b/docs/troubleshoot.md @@ -34,4 +34,6 @@ Less frequently used commands: helm init --service-account tiller --upgrade ``` -If you have any other issues with installation, email . +Any other issues? Contact us at [@srcgraph](https://twitter.com/srcgraph) +or , or file issues on +our [public issue tracker](https://github.com/sourcegraph/issues/issues).