Skip to content

Commit

Permalink
Replace all references to Gitter with Community Slack
Browse files Browse the repository at this point in the history
  • Loading branch information
jseldess committed Jun 12, 2020
1 parent 5c1d2fa commit 164f9de
Show file tree
Hide file tree
Showing 51 changed files with 167 additions and 250 deletions.
2 changes: 1 addition & 1 deletion archived/training/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ This training introduces you to the fundamentals of CockroachDB, with an emphasi
- **Understanding the architecture**
- **Operational basics**

The modules build on each other, so it's important to complete them in order. As you go, feel free to ask questions on our public [Gitter chat channel](https://gitter.im/cockroachdb/cockroach) or [support forum](https://forum.cockroachlabs.com/).
The modules build on each other, so it's important to complete them in order. As you go, feel free to ask questions on our public [CockroachDB Community Slack](https://cockroachdb.slack.com) or [support forum](https://forum.cockroachlabs.com/).

<!-- Once you've finished, [let us know if you are interested in more detailed training](https://www.surveymonkey.com/r/5TGPWRJ) on deploying, monitoring, troubleshooting, and maintaining CockroachDB. -->

Expand Down
1 change: 0 additions & 1 deletion releases/beta-20160505.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,6 @@ Get future release notes emailed to you:

### Doc Updates

* Users can now click **Chat with Developers** in the lower right corner of any docs page to access the public [CockroachDB Gitter channel](https://gitter.im/cockroachdb/cockroach) without leaving the site. [#248](https://github.com/cockroachdb/docs/pull/248)
* Community-supported docs and configuration files for [running CockroachDB inside a single VirtualBox virtual machine](http://uptimedba.github.io/cockroach-vb-single/cockroach-vb-single/home.html). [#263](https://github.com/cockroachdb/docs/pull/263)
* Docs on using [environment variables](../v1.0/cockroach-commands.html#environment-variables) as default values for command-line flags. [#235](https://github.com/cockroachdb/docs/pull/235)
* Docs on using the [`version`](../v1.0/view-version-details.html) and [`node`](../v1.0/view-node-details.html) commands.
Expand Down
5 changes: 3 additions & 2 deletions v1.0/cluster-setup-troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -188,6 +188,7 @@ If data is not being replicated to some nodes in the cluster, we recommend check
If we do not have a solution here, you can try using our other [support resources](support-resources.html), including:
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Community Forum](https://forum.cockroachlabs.com)
- [Chatting with our developers on Gitter](https://gitter.im/cockroachdb/cockroach) (To open Gitter without leaving these docs, click **Help** in the lower-right corner of any page.)
- [CockroachDB Community Slack](https://cockroachdb.slack.com)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Support Portal](https://support.cockroachlabs.com)
18 changes: 2 additions & 16 deletions v1.0/file-an-issue.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,20 +6,6 @@ toc: false

If you've tried to [troubleshoot](troubleshooting-overview.html) an issue yourself, have [reached out for help](support-resources.html), and are still stumped, you can file an issue in GitHub.

## Guidance

Before filing an issue:

- Read the details of the relevant documentation. For example, it's important to understand the function of all flags when [starting nodes](start-a-node.html).
- Review our [troubleshooting documentation](troubleshooting-overview.html).
- Check our [open issues](https://github.com/cockroachdb/cockroach/issues) for existing tickets related to your problem. Specifically, the [known limitation](https://github.com/cockroachdb/cockroach/issues?q=is%3Aopen+is%3Aissue+label%3Aknown-limitation), [UX surprise](https://github.com/cockroachdb/cockroach/issues?utf8=%E2%9C%93&q=is%3Aopen%20is%3Aissue%20label%3Aux-surprise) and [SQL semantics](https://github.com/cockroachdb/cockroach/issues?utf8=%E2%9C%93&q=is%3Aopen%20is%3Aissue%20label%3Asql-semantics) flags. If you've encountered one of these issues, please leave a comment about your use case.
- Use our [support resources](support-resources.html), including:
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Community Forum](https://forum.cockroachlabs.com)
- [Gitter](https://gitter.im/cockroachdb/cockroach)

## Filing an Issue

To file an issue in GitHub, we need the following information:

1. A summary of the issue.
Expand All @@ -31,7 +17,7 @@ To file an issue in GitHub, we need the following information:
4. The result that actually occurred.

5. The first few lines of the log file from each node in the cluster in a timeframe as close as possible to reproducing the issue. On most Unix-based systems running with defaults, you can get this information using the following command:

~~~ shell
$ grep -F '[config]' cockroach-data/logs/cockroach.log
~~~~
Expand All @@ -50,7 +36,7 @@ You can use this as a template for [filing an issue in GitHub](https://github.co

## Steps to reproduce

1.
1.
2.
3.

Expand Down
9 changes: 5 additions & 4 deletions v1.0/frequently-asked-questions.md
Original file line number Diff line number Diff line change
Expand Up @@ -163,8 +163,9 @@ Not yet, but this is on our long-term roadmap.

## Have questions that weren’t answered?

- [CockroachDB Community Forum](https://forum.cockroachlabs.com): Ask questions, find answers, and help other users.
- [Join us on Gitter](https://gitter.im/cockroachdb/cockroach): This is the most immediate way to connect with CockroachDB engineers. To open Gitter without leaving these docs, click **Chat with Developers** in the lower-right corner of any page.
- [SQL FAQs](sql-faqs.html): Get answers to frequently asked questions about CockroachDB SQL.
- [Operational FAQS](operational-faqs.html): Get answers to frequently asked questions about operating CockroachDB.
Try searching the rest of our docs for answers or using our other [support resources](support-resources.html), including:

- [CockroachDB Community Forum](https://forum.cockroachlabs.com)
- [CockroachDB Community Slack](https://cockroachdb.slack.com)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Support Portal](https://support.cockroachlabs.com)
8 changes: 4 additions & 4 deletions v1.0/general-troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ This page helps with general troubleshooting steps that apply to many different
## Common Troubleshooting Steps

If you run into issues with CockroachDB, there are a few steps you can always take:

- Check your [logs](debug-and-error-logs.html) for errors related to your issue. Logs are generated on a per-node basis, so you must either identify the node where the issue occurred or [collect the logs from all active nodes in your cluster](debug-zip.html).

- [Stop](stop-a-node.html) and [restart](start-a-node.html) problematic nodes with the `--logtostderr` flag. This option prints logs to your terminal through `stderr`, letting you see all of your cluster's activities as they occur.
Expand Down Expand Up @@ -70,7 +70,7 @@ See [Configure Replication Zones](configure-replication-zones.html) for more det

If we do not have a solution here, you can try using our other [support resources](support-resources.html), including:

- [Other troubleshooting pages](troubleshooting-overview.html)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Community Forum](https://forum.cockroachlabs.com)
- [Chatting with our developers on Gitter](https://gitter.im/cockroachdb/cockroach) (To open Gitter without leaving these docs, click **Help** in the lower-right corner of any page.)
- [CockroachDB Community Slack](https://cockroachdb.slack.com)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Support Portal](https://support.cockroachlabs.com)
7 changes: 4 additions & 3 deletions v1.0/query-behavior-troubleshooting.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Query Behavior Troubleshooting
summary: Learn how to troubleshoot issues with specific queries with CockroachDB
summary: Learn how to troubleshoot issues with specific queries with CockroachDB
toc: true
---

Expand Down Expand Up @@ -37,6 +37,7 @@ Because this kind of behavior is entirely unexpected, you should [file an issue]

If we do not have a solution here, you can try using our other [support resources](support-resources.html), including:

- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Community Forum](https://forum.cockroachlabs.com)
- [Chatting with our developers on Gitter](https://gitter.im/cockroachdb/cockroach) (To open Gitter without leaving these docs, click **Help** in the lower-right corner of any page.)
- [CockroachDB Community Slack](https://cockroachdb.slack.com)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Support Portal](https://support.cockroachlabs.com)
3 changes: 1 addition & 2 deletions v1.0/serial.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,7 @@ The `SERIAL` [data type](data-types.html) is a column data type that, on insert,

{{site.data.alerts.callout_info}}
We believe this data type is a better solution than PostgreSQL's <code>SERIAL</code> and MySQL's <code>AUTO_INCREMENT</code> types, both of which auto-increment integers but not necessarily in a strictly sequential fashion (see the <a href="#auto-incrementing-is-not-always-sequential"> Auto-Incrementing Is Not Always Sequential </a> example below). However, if you find that this feature is incompatible with your application, please <a href="https://github.com/cockroachdb/cockroach/issues">open an
issue</a> or <a href="https://gitter.im/cockroachdb/cockroach">chat
with us on Gitter</a>.
issue</a>.
{{site.data.alerts.end}}


Expand Down
7 changes: 4 additions & 3 deletions v1.0/support-resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,10 @@ toc: false
If you're having an issue with CockroachDB, you can reach out for support from Cockroach Labs and our community:

- [Troubleshooting documentation](troubleshooting-overview.html)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Community Forum](https://forum.cockroachlabs.com)
- [Gitter](https://gitter.im/cockroachdb/cockroach)
- [CockroachDB Community Slack](https://cockroachdb.slack.com)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [File a GitHub issue](file-an-issue.html)
- [CockroachDB Support Portal](https://support.cockroachlabs.com)

Because CockroachDB is open source, we also rely on contributions from users like you. If you know how to help users who might be struggling with a problem, we hope you will!
We also rely on contributions from users like you. If you know how to help users who might be struggling with a problem, we hope you will!
10 changes: 5 additions & 5 deletions v1.0/troubleshoot.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,9 +96,9 @@ When running a multi-node CockroachDB cluster, if you see an error like the one

## Something Else?

If we do not have an solution here, you can try:

- [CockroachDB Community Forum](https://forum.cockroachlabs.com): Ask questions, find answers, and help other users.
- [Join us on Gitter](https://gitter.im/cockroachdb/cockroach): This is the most immediate way to connect with CockroachDB engineers. To open Gitter without leaving these docs, click **Chat with Developers** in the lower-right corner of any page.
- **Send Us Feedback**: In the **Was this page helpful?** section below, click **No**, and then send us details about your issue.
If we do not have a solution here, you can try using our other [support resources](support-resources.html), including:

- [CockroachDB Community Forum](https://forum.cockroachlabs.com)
- [CockroachDB Community Slack](https://cockroachdb.slack.com)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Support Portal](https://support.cockroachlabs.com)
5 changes: 3 additions & 2 deletions v1.1/cluster-setup-troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -188,6 +188,7 @@ If data is not being replicated to some nodes in the cluster, we recommend check
If we do not have a solution here, you can try using our other [support resources](support-resources.html), including:
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Community Forum](https://forum.cockroachlabs.com)
- [Chatting with our developers on Gitter](https://gitter.im/cockroachdb/cockroach) (To open Gitter without leaving these docs, click **Help** in the lower-right corner of any page.)
- [CockroachDB Community Slack](https://cockroachdb.slack.com)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Support Portal](https://support.cockroachlabs.com)
8 changes: 4 additions & 4 deletions v1.1/common-errors.md
Original file line number Diff line number Diff line change
Expand Up @@ -155,9 +155,9 @@ This message occurs when a component of CockroachDB gives up because it was rely

## Something Else?

If we do not have a solution here, you can try using our other [support resources](support-resources.html), including:
Try searching the rest of our docs for answers or using our other [support resources](support-resources.html), including:

- [Other troubleshooting pages](troubleshooting-overview.html)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Community Forum](https://forum.cockroachlabs.com)
- [Chatting with our developers on Gitter](https://gitter.im/cockroachdb/cockroach) (To open Gitter without leaving these docs, click **Help** in the lower-right corner of any page.)
- [CockroachDB Community Slack](https://cockroachdb.slack.com)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Support Portal](https://support.cockroachlabs.com)
18 changes: 2 additions & 16 deletions v1.1/file-an-issue.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,20 +6,6 @@ toc: false

If you've tried to [troubleshoot](troubleshooting-overview.html) an issue yourself, have [reached out for help](support-resources.html), and are still stumped, you can file an issue in GitHub.

## Guidance

Before filing an issue:

- Read the details of the relevant documentation. For example, it's important to understand the function of all flags when [starting nodes](start-a-node.html).
- Review our [troubleshooting documentation](troubleshooting-overview.html).
- Check our [open issues](https://github.com/cockroachdb/cockroach/issues) for existing tickets related to your problem. Specifically, the [known limitation](https://github.com/cockroachdb/cockroach/issues?q=is%3Aopen+is%3Aissue+label%3Aknown-limitation), [UX surprise](https://github.com/cockroachdb/cockroach/issues?utf8=%E2%9C%93&q=is%3Aopen%20is%3Aissue%20label%3Aux-surprise) and [SQL semantics](https://github.com/cockroachdb/cockroach/issues?utf8=%E2%9C%93&q=is%3Aopen%20is%3Aissue%20label%3Asql-semantics) flags. If you've encountered one of these issues, please leave a comment about your use case.
- Use our [support resources](support-resources.html), including:
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Community Forum](https://forum.cockroachlabs.com)
- [Gitter](https://gitter.im/cockroachdb/cockroach)

## Filing an Issue

To file an issue in GitHub, we need the following information:

1. A summary of the issue.
Expand All @@ -31,7 +17,7 @@ To file an issue in GitHub, we need the following information:
4. The result that actually occurred.

5. The first few lines of the log file from each node in the cluster in a timeframe as close as possible to reproducing the issue. On most Unix-based systems running with defaults, you can get this information using the following command:

~~~ shell
$ grep -F '[config]' cockroach-data/logs/cockroach.log
~~~~
Expand All @@ -50,7 +36,7 @@ You can use this as a template for [filing an issue in GitHub](https://github.co

## Steps to reproduce

1.
1.
2.
3.

Expand Down
9 changes: 5 additions & 4 deletions v1.1/frequently-asked-questions.md
Original file line number Diff line number Diff line change
Expand Up @@ -168,8 +168,9 @@ Not yet, but this is on our long-term roadmap.

## Have questions that weren’t answered?

- [CockroachDB Community Forum](https://forum.cockroachlabs.com): Ask questions, find answers, and help other users.
- [Join us on Gitter](https://gitter.im/cockroachdb/cockroach): This is the most immediate way to connect with CockroachDB engineers. To open Gitter without leaving these docs, click **Chat with Developers** in the lower-right corner of any page.
- [SQL FAQs](sql-faqs.html): Get answers to frequently asked questions about CockroachDB SQL.
- [Operational FAQS](operational-faqs.html): Get answers to frequently asked questions about operating CockroachDB.
Try searching the rest of our docs for answers or using our other [support resources](support-resources.html), including:

- [CockroachDB Community Forum](https://forum.cockroachlabs.com)
- [CockroachDB Community Slack](https://cockroachdb.slack.com)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Support Portal](https://support.cockroachlabs.com)
7 changes: 4 additions & 3 deletions v1.1/query-behavior-troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,8 +35,9 @@ Because this kind of behavior is entirely unexpected, you should [file an issue]

## Something Else?

If we do not have a solution here, you can try using our other [support resources](support-resources.html), including:
Try searching the rest of our docs for answers or using our other [support resources](support-resources.html), including:

- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Community Forum](https://forum.cockroachlabs.com)
- [Chatting with our developers on Gitter](https://gitter.im/cockroachdb/cockroach) (To open Gitter without leaving these docs, click **Help** in the lower-right corner of any page.)
- [CockroachDB Community Slack](https://cockroachdb.slack.com)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Support Portal](https://support.cockroachlabs.com)
5 changes: 3 additions & 2 deletions v1.1/support-resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,10 @@ toc: false
If you're having an issue with CockroachDB, you can reach out for support from Cockroach Labs and our community:

- [Troubleshooting documentation](troubleshooting-overview.html)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Community Forum](https://forum.cockroachlabs.com)
- [Gitter](https://gitter.im/cockroachdb/cockroach)
- [CockroachDB Community Slack](https://cockroachdb.slack.com)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [File a GitHub issue](file-an-issue.html)
- [CockroachDB Support Portal](https://support.cockroachlabs.com)

Because CockroachDB is open source, we also rely on contributions from users like you. If you know how to help users who might be struggling with a problem, we hope you will!
7 changes: 4 additions & 3 deletions v19.1/cluster-setup-troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -434,8 +434,9 @@ If you still see under-replicated/unavailable ranges on the Cluster Overview pag
## Something else?
If we do not have a solution here, you can try using our other [support resources](support-resources.html), including:
Try searching the rest of our docs for answers or using our other [support resources](support-resources.html), including:
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Community Forum](https://forum.cockroachlabs.com)
- [Chatting with our developers on Gitter](https://gitter.im/cockroachdb/cockroach) (To open Gitter without leaving these docs, click **Help** in the lower-right corner of any page.)
- [CockroachDB Community Slack](https://cockroachdb.slack.com)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Support Portal](https://support.cockroachlabs.com)
8 changes: 4 additions & 4 deletions v19.1/common-errors.md
Original file line number Diff line number Diff line change
Expand Up @@ -252,9 +252,9 @@ For details about other libraries the CockroachDB binary depends on, see [Depend
## Something else?
If we do not have a solution here, you can try using our other [support resources](support-resources.html), including:
Try searching the rest of our docs for answers or using our other [support resources](support-resources.html), including:
- [Other troubleshooting pages](troubleshooting-overview.html)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Community Forum](https://forum.cockroachlabs.com)
- [Chatting with our developers on Gitter](https://gitter.im/cockroachdb/cockroach) (To open Gitter without leaving these docs, click **Help** in the lower-right corner of any page.)
- [CockroachDB Community Slack](https://cockroachdb.slack.com)
- [StackOverflow](http://stackoverflow.com/questions/tagged/cockroachdb)
- [CockroachDB Support Portal](https://support.cockroachlabs.com)
Loading

0 comments on commit 164f9de

Please sign in to comment.