implement Installation.md and document using setup-go#2190
Merged
gdams merged 8 commits intomicrosoft/mainfrom Mar 18, 2026
Merged
implement Installation.md and document using setup-go#2190gdams merged 8 commits intomicrosoft/mainfrom
gdams merged 8 commits intomicrosoft/mainfrom
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Consolidates end-user installation instructions for the Microsoft build of Go into a dedicated eng/doc/Installation.md, and updates existing docs to point to that centralized guide.
Changes:
- Add a new
eng/doc/Installation.mdcontaining installation options (packages, CI integrations, archives, and build-from-source). - Replace the README “Download and install” content with a short, linked list of installation methods.
- Update the Migration Guide to reference the new Installation guide for CI acquisition guidance.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.
| File | Description |
|---|---|
| eng/doc/MigrationGuide.md | Points CI install guidance to the new Installation guide, but needs follow-up link fixes for removed README anchors / removed internal section anchor. |
| eng/doc/Installation.md | New consolidated installation doc (needs a few doc/link corrections). |
| README.md | Replaces inline install instructions with links into eng/doc/Installation.md. |
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Updated link in MigrationGuide.md to point to Installation.md.
qmuntal
requested changes
Mar 17, 2026
Co-authored-by: Quim Muntal <qmuntaldiaz@microsoft.com>
qmuntal
approved these changes
Mar 17, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
This PR consolidates installation documentation into a dedicated eng/doc/Installation.md page and updates existing docs to link to it, reducing duplication between the README and migration guidance.
Changes:
- Added
eng/doc/Installation.mdto centralize all supported installation methods (OS packages, CI, scripts, archives, and source builds). - Updated
README.mdto replace the detailed install section with a short, linked table-of-contents style list. - Updated
eng/doc/MigrationGuide.mdto reference the new Installation guide (including CI guidance for Azure Pipelines and GitHub Actions).
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
| eng/doc/MigrationGuide.md | Repoints installation guidance to Installation.md and adds links for CI-specific installation approaches. |
| eng/doc/Installation.md | New consolidated installation guide covering all supported acquisition/install paths. |
| README.md | Replaces duplicated install instructions with bullet links into eng/doc/Installation.md. |
Corrected the link to the Installation Guide for Ubuntu golang package.
dagood
approved these changes
Mar 17, 2026
README.md
Outdated
| `eng/run.ps1` and other repository infrastructure. | ||
|
|
||
| Once built, the Microsoft build of Go binary is found at `go/bin/go`. | ||
| The following installation methods are available. See [Installation](eng/doc/Installation.md) for full details. |
Member
There was a problem hiding this comment.
I think we should try to make sure it doesn't seem like "full details" are different from what you get by clicking one of the links below.
Suggested change
| The following installation methods are available. See [Installation](eng/doc/Installation.md) for full details. | |
| The [Installation](eng/doc/Installation.md) documentation contains sections describing each of the following installation methods: |
dagood
requested changes
Mar 17, 2026
dagood
approved these changes
Mar 17, 2026
Member
Member
|
FYI: I have some polishing that I plan to put in separate PRs--will include my suggestion in that. |
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.
Consolidates installation methods into a single markdown file with bullet links from the README.md and Migration Guide