[v13] Simplify the Getting Started experience#25519
Merged
ptgott merged 1 commit intobranch/v13from May 9, 2023
Merged
Conversation
zmb3
approved these changes
May 2, 2023
This change makes the experience of getting started with Teleport more opinionated and more precisely molded around our intended audience. The assumption is that people who want to go through our getting started experience are skilled technologists who: - Are curious about how Teleport works and want to tinker with a toy cluster - Need to set up a production cluster in order to protect their infrastructure, in which case a toy cluster is less important than a way to get started with the real thing Promote the "Linux Server" guide -------------------------------- Make the "Linux Server" guide the definitive introduction to OSS Teleport by removing other "Try out Teleport" guides and moving this one to the "Home" section. We want to remove the need for users to decide which getting started guide to try, and this guide is the only one that lets users spin up a fully fledged demo cluster besides the Digital Ocean guide. To let users know about the DigitalOcean 1-Click droplet, this change links to our DigitalOcean 1-Click app from within the Linux Server guide. It also advises users who don't meet the Linux Server guide prerequisites to sign up for a Teleport Enterprise Cloud free trial. This change also removes the Docker guide and redirects Docker-related traffic to the Installation page, since the Docker guide is more of a Getting Started guide than an integration guide, and our Installation page already includes Docker setup information. Edit the Linux Server getting started guide ------------------------------------------- - Remove Application Service instructions, since it can turn off users who, for example, don't use Python or don't want to run the Application Service (plus we already mention it at the end of the guide for users who do want to run this service). - Update installation instructions to use our one-liner. - Make this guide more explicitly focused on the Open Source edition, removing Enterprise instructions. Users who want to tinker with Teleport will not be interested in the Enterprise edition. - Add session recording instructions. Most of the content of the Linux Server guide has to do with setting up Teleport, rather than seeing Teleport features, so I wanted to adjust this balance a bit. - Remove the permission warning. It takes up around 1/4 of the screen height when viewing the page, and we expect our intended audience to know this information already. Change the Enterprise information architecture ---------------------------------------------- - Remove the Enterprise "Getting Started" guide: This guide shows you how to deploy a demo Teleport Enterprise cluster, which is sort of a contradiction in terms. Enterprise users expect a production-grade cluster, which is not what you get in this guide. - In the Enterprise Introduction page, include instructions to read the Deployment Guides, which show how to set up a mature HA deployment, plus a recommendation to use Teleport Enterprise Cloud unless you need the Enterprise-specific features explained in this guide.
ptgott
force-pushed
the
bot/backport-25415-branch/v13
branch
from
86e5875 to
193dee5
Compare
stevenGravy
approved these changes
May 9, 2023
Closed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Backport #25415 to branch/v13