docs: add macOS and Linux install instructions to the researcher guide#5
Merged
Merged
Conversation
…e [REPORT-77] Replace the TBD placeholder in the researcher guide with real install steps now that the signed/notarized release and Homebrew tap are live: macOS via Homebrew (including the Homebrew 6.0 'brew tap --trust' requirement) or direct download, Linux via Homebrew-on-Linux or a direct tarball, plus a build-from-source path.
There was a problem hiding this comment.
Pull request overview
Updates the researcher guide to replace the “TBD” install placeholder with concrete installation paths now that signed/notarized releases and a Homebrew tap are available.
Changes:
- Adds macOS install instructions (Homebrew + direct download) with notes about Gatekeeper/notarization behavior.
- Adds Linux (x86-64) install instructions (Homebrew-on-Linux + direct download) and ARM guidance.
- Adds “build from source” instructions including Go/C toolchain requirements.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
…RT-77] Address the Copilot review on the install section: say cc-data ships prebuilt binaries for macOS and Linux (source builds work anywhere, including Windows) to avoid implying no Windows support, and reference the full release asset filenames (cc-data_<version>_darwin_<arch>.tar.gz) so they're findable on the Releases page.
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
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.
Summary
Replaces the "TBD" placeholder in the researcher guide's "Installing the CLI" section with real instructions, now that the signed + notarized release and the
concord-consortium/homebrew-tapare working end to end.Covers
brew tap --truststep that Homebrew 6.0+ requires for third-party taps, plus a "without Homebrew" direct-download path noting the notarized binary's first-run online check.curl+ extract + install, with a note that ARM Linux needs a source build.go build, noting Go 1.25+ and the C compiler needed for the DuckDB cgo dependency, and that a source build reports its version asdev.Windows is intentionally omitted (no Windows binary is built or published).
Notes
vX.Y.Zplaceholder pointing at the Releases page rather than a hardcoded version, since only pre-release test tags exist so far. Worth revisiting once a real version is cut.