Skip to content

Direct users to official Linux install instruction #19625

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.

Sign up for GitHub

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

Jump to bottom
Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Direct users to official Linux install instruction #19625

wants to merge 1 commit into from

Conversation

rmloveland
Copy link
Contributor

... not bespoke curl commands that can break.

Fixes DOC-13739

@rmloveland
Direct users to official Linux install instruction
f42ceb1 
... not bespoke `curl` commands that can break.

Fixes DOC-13739
@netlify Netlify
Copy link

netlify bot commented May 21, 2025

✅ Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit f42ceb1
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-api-docs/deploys/682e1564216b900008292540

@netlify Netlify
Copy link

netlify bot commented May 21, 2025

✅ Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit f42ceb1
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/682e15634826a50008d12085

@github-actions GitHub Actions
Copy link

Files changed:

@netlify Netlify
Copy link

netlify bot commented May 21, 2025

✅ Netlify Preview

Name Link
🔨 Latest commit f42ceb1
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/682e1563d2891600084312fa
😎 Deploy Preview https://deploy-preview-19625--cockroachdb-docs.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 project configuration.

@rmloveland rmloveland requested a review from taroface May 21, 2025 20:06
@rmloveland
Copy link
Contributor Author

@taroface i took a shot at just pointing users to the official install instructions & getting rid of the bespoke curl commands. PTAL! Once we get something we're happy with, I'll backport it to our other supported versions v23.1+

@rmloveland rmloveland requested a review from jhlodin May 21, 2025 20:08
@rmloveland
Copy link
Contributor Author

@jhlodin adding you as an FYI since this is a 'deployment & ops' change

@taroface
Copy link
Contributor

To be clear, the intent is to link people to the doc that takes them down a more regularly maintained flow to find the binaries they want, right?

If so, it looks like the Install Linux page links out to the CockroachDB Releases page, and you kinda have to dig for a moment to find this. Would it be friendlier to just link directly to that section (substituting the page version)? eg, https://www.cockroachlabs.com/docs/releases?#v25-2

I don't feel strongly about this but wondering what you and @jhlodin think.

@jhlodin
Copy link
Contributor

jhlodin commented May 22, 2025

+1 to what Ryan said, but also the new target page doesn't actually have any instructions for downloading, extracting, and adding the binary to the PATH. In other words, this now sends people off to another page to be told to run commands that were on the original page.

I think the general idea of updating these snippets to point to the Linux install doc is on-point, but the common download/extract/copy code blocks need to move to the install doc.

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

@taroface taroface Awaiting requested review from taroface

@jhlodin jhlodin Awaiting requested review from jhlodin

Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
3 participants
@rmloveland @taroface @jhlodin