Skip to content

Add client compatibility to installation guide#25548

Merged
tigrato merged 3 commits intomasterfrom
tigrato/installation-docs
May 5, 2023
Merged

Add client compatibility to installation guide#25548
tigrato merged 3 commits intomasterfrom
tigrato/installation-docs

Conversation

@tigrato
Copy link
Copy Markdown
Contributor

@tigrato tigrato commented May 3, 2023

This PR adds a note to emphasize that clients must be at the same major version as Teleport servers

This PR adds a note to emphasize that clients must be at the same major version as Teleport servers
Comment thread docs/pages/installation.mdx Outdated
Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>
Comment thread docs/pages/installation.mdx Outdated

</Admonition>

<Admonition type="warning" title="Teleport client compatibility">
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

The successive Admonitions appear pretty busy to me:
image

I think we can strip both Admonition wrappers and add an intro sentence so the text flows more smoothly, making the first part of the guide looks like this:

This guide shows you how to install Teleport binaries on your platform,
including:
- `teleport`
- `tsh`
- `tctl`
- `tbot`

If you are new to Teleport, we recommend following our [getting started 
guide](http://localhost:3000/docs/get-started/).

For best results, Teleport clients (tsh, tctl, tbot) should be the same major
version as the cluster they are connecting to. Teleport servers are compatible
with clients that are on the same major version or one major version older. 
Teleport servers do not support clients that are on a newer major version.

See our [Upgrading](http://localhost:3000/docs/management/operations/upgrading/) guide for more information.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Added in b8c4361

@tigrato tigrato added this pull request to the merge queue May 5, 2023
Merged via the queue into master with commit 14e4e52 May 5, 2023
@tigrato tigrato deleted the tigrato/installation-docs branch May 5, 2023 08:51
@public-teleport-github-review-bot
Copy link
Copy Markdown

@tigrato See the table below for backport results.

Branch Result
branch/v11 Failed
branch/v12 Create PR
branch/v13 Create PR

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants