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

Update docs for https://github.com/vitessio/vitess/pull/17442 #1912

Open
wants to merge 5 commits into
base: prod
Choose a base branch
from

Conversation

Copy link

netlify bot commented Jan 3, 2025

Deploy Preview for vitess ready!

Name Link
🔨 Latest commit 6c3a679
🔍 Latest deploy log https://app.netlify.com/sites/vitess/deploys/678942c8ec81e90008159ae0
😎 Deploy Preview https://deploy-preview-1912--vitess.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@mattlord mattlord requested a review from deepthi January 16, 2025 17:18
@deepthi
Copy link
Member

deepthi commented Jan 24, 2025

Do we list all net-new commands on the diff page?

@@ -2,8 +2,10 @@
title: vtctl
Copy link
Member

Choose a reason for hiding this comment

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

Should we just replace this with vtctldclient?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

I'm not sure. We frame the concept of vtctl here as being the pairing of the client and server. I'd follow your lead here.

@@ -2,8 +2,10 @@
title: vtctl
---

**vtctl** is a command-line tool used to administer a Vitess cluster. It is available as both a standalone tool (`vtctl`) and client-server (`vtctldclient` in combination with `vtctld`). Using client-server is recommended, as it provides an additional layer of security when using the client remotely.
**vtctl** is a command-line tool, `vtctldclient`, that is used as both a standalone tool (`vtctldclient --server=internal`) and client-server (`vtctldclient` in combination with `vtctld`) to administer a Vitess cluster. Using client-server is recommended, as it provides an additional layer of security when using the client remotely.
Copy link
Member

Choose a reason for hiding this comment

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

Same here. We can probably get rid of vtctl terminology now.

Copy link
Collaborator Author

@mattlord mattlord Jan 24, 2025

Choose a reason for hiding this comment

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

Here it definitely seems off. In your mind, is vtctl a binary (same name) and a concept (client and server binaries)? If it's really just the former then we should definitely remove usage of it. My reading of the page was that it's a concept that spans the client and server pieces but maybe I just misread it.

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.

3 participants