Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Update to helm usage by default #413

Merged
merged 2 commits into from Jun 8, 2022
Merged

docs: Update to helm usage by default #413

merged 2 commits into from Jun 8, 2022

Conversation

onprem
Copy link
Contributor

@onprem onprem commented Jun 7, 2022

Signed-off-by: Prem Saraswat prmsrswt@gmail.com

Description

Fixes #393

Type of change

What type of changes does your code introduce to tobs? Put an x in the box that apply.

  • CHANGE (fix or feature that would cause existing functionality to not work as expected)
  • FEATURE (non-breaking change which adds functionality)
  • BUGFIX (non-breaking change which fixes an issue)
  • ENHANCEMENT (non-breaking change which improves existing functionality)
  • NONE (if none of the other choices apply. Example, tooling, build system, CI, docs, etc.)

Signed-off-by: Prem Saraswat <prmsrswt@gmail.com>
README.md Outdated
## Installing the CLI tool
## Prerequisites

Using tobs to install full observability stack with openTelemetry support currently requires installation of cert-manager. To do install it please follow [cert-manager documentation](https://cert-manager.io/docs/installation/).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Using tobs to install full observability stack with openTelemetry support currently requires installation of cert-manager. To do install it please follow [cert-manager documentation](https://cert-manager.io/docs/installation/).
Using tobs to install full observability stack with openTelemetry support currently requires installation of cert-manager.
To install it please follow [cert-manager documentation](https://cert-manager.io/docs/installation/).

README.md Outdated
We also have additional documentation about individual configuration settings in our
[Helm chart docs](chart/README.md#configuring-helm-chart).

# 🛠Alternative deployment methods
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
# 🛠Alternative deployment methods
# Alternative deployment methods

WDYT about dropping emojis from the doc?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Dropped them for now. I don't have any strong opinions about it.

README.md Outdated
We also have additional documentation about individual configuration settings in our
[Helm chart docs](chart/README.md#configuring-helm-chart).

# 🛠Alternative deployment methods
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
# 🛠Alternative deployment methods
# Alternative deployment methods

WDYT about dropping emojis from the doc?

README.md Outdated

*NOTE*: At this point, the CLI tool is just a thin wrapper around the helm chart, and hence it's set to be removed in future releases.

### Installing the CLI tool
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could we drop it and instead point to cli/README.md doc?

README.md Outdated

*NOTE*: At this point, the CLI tool is just a thin wrapper around the helm chart, and hence it's set to be removed in future releases.

### Installing the CLI tool
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could we drop all sub-sections of cli installation and instead point to cli/README.md doc?

README.md Outdated

# 🛠Alternative deployment methods

## [DEPRECATED] Using the `tobs` CLI tool
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## [DEPRECATED] Using the `tobs` CLI tool
## Using the `tobs` CLI tool

It's not yet deprecated. It will be after next release (0.11.0).

README.md Outdated

# 🛠Alternative deployment methods

## [DEPRECATED] Using the `tobs` CLI tool
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## [DEPRECATED] Using the `tobs` CLI tool
## Using the `tobs` CLI tool

It's not yet deprecated. It will be after next release (0.11.0).

README.md Outdated
@@ -45,7 +80,7 @@ Alternatively, you can download the CLI directly via [our releases page](https:/

Getting started with the CLI tool is a two-step process: First you install the CLI tool locally, then you use the CLI tool to install the tobs stack into your Kubernetes cluster.

## Using the tobs CLI tool to deploy the stack into your Kubernetes cluster
### Using the tobs CLI tool to deploy the stack into your Kubernetes cluster
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same as above.

Signed-off-by: Prem Saraswat <prmsrswt@gmail.com>
@onprem onprem marked this pull request as ready for review June 8, 2022 13:40
@onprem onprem requested a review from a team as a code owner June 8, 2022 13:40
@onprem onprem requested a review from paulfantom June 8, 2022 13:40
README.md Outdated
## Installing the CLI tool
## Prerequisites

Using tobs to install full observability stack with openTelemetry support currently requires installation of cert-manager. To do install it please follow [cert-manager documentation](https://cert-manager.io/docs/installation/).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Using tobs to install full observability stack with openTelemetry support currently requires installation of cert-manager. To do install it please follow [cert-manager documentation](https://cert-manager.io/docs/installation/).
Using tobs to install full observability stack with openTelemetry support currently requires installation of cert-manager.
To install it please follow [cert-manager documentation](https://cert-manager.io/docs/installation/).

@paulfantom paulfantom merged commit 8eb8125 into timescale:master Jun 8, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Update docs to not reference tobs CLI and point to helm usage
2 participants