docs: use distinct binary name for optimized builds and clarify release parity#2105
Merged
devantler merged 2 commits intodocs/document-build-optimizations-759e3b5e17a2f37dfrom Feb 8, 2026
Conversation
Co-authored-by: devantler <26203420+devantler@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Document build optimization flags in contributor guide
docs: use distinct binary name for optimized builds and clarify release parity
Feb 8, 2026
github-project-automation
bot
moved this from 🏃🏻♂️ In Progress
to ✅ Done
in 🌊 Project Board
github-merge-queue bot
pushed a commit
that referenced
this pull request
Feb 11, 2026
* docs: document build optimization flags in contributor guide Add documentation for -ldflags="-s -w" build optimization that reduces binary size by ~28% (302MB → 217MB). This helps contributors understand the difference between development builds and release artifacts. Changes: - CONTRIBUTING.md: Add production build command with optimization flags - .github/copilot-instructions.md: Add optimization note to build section Relates to: #2095 * Update CONTRIBUTING.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Nikolai Emil Damm <ned@devantler.tech> * Update .github/copilot-instructions.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Nikolai Emil Damm <ned@devantler.tech> * Update .github/copilot-instructions.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Nikolai Emil Damm <ned@devantler.tech> * docs: use distinct binary name for optimized builds and clarify release parity (#2105) * Initial plan * docs: use distinct binary name for optimized builds and clarify wording Co-authored-by: devantler <26203420+devantler@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: devantler <26203420+devantler@users.noreply.github.com> * docs: include specific benchmark numbers in build optimization note (#2110) --------- Signed-off-by: Nikolai Emil Damm <ned@devantler.tech> Co-authored-by: Update Docs Bot <docs-bot@devantler-tech.com> Co-authored-by: Nikolai Emil Damm <ned@devantler.tech> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com> Co-authored-by: devantler <26203420+devantler@users.noreply.github.com>
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.
Addresses review feedback on build optimization documentation to prevent confusion about development vs. release builds and avoid overwriting binaries.
Changes
ksail→ksail-optimizedfor the optimized build command, preventing developers from accidentally overwriting their debug-enabled binary and enabling side-by-side comparisonCGO_ENABLED=0(which is set in actual release builds via GoReleaser)CONTRIBUTING.mdand.github/copilot-instructions.mdThis allows contributors to experiment with both build variants without losing their development binary and sets accurate expectations about what the command produces.
💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.