Skip to content

Update linux.md documentation to reflect current CI build configuration#26255

Merged
TravisEz13 merged 4 commits into
masterfrom
copilot/update-linux-documentation
Oct 21, 2025
Merged

Update linux.md documentation to reflect current CI build configuration#26255
TravisEz13 merged 4 commits into
masterfrom
copilot/update-linux-documentation

Conversation

Copilot AI commented Oct 20, 2025

Copy link
Copy Markdown
Contributor

Summary

The docs/building/linux.md documentation was outdated and did not reflect the current build process used in the linux-ci workflow. This PR updates the documentation to match the actual CI configuration and current codebase.

Changes

Ubuntu Version

Updated the Ubuntu version reference from "Ubuntu 16.04 LTS" to "Ubuntu 24.04 LTS (the CI uses ubuntu-latest)" to reflect the specific version that ubuntu-latest currently refers to, as shown in .github/workflows/linux-ci.yml.

.NET SDK Version

Updated the .NET SDK version from "2.0.0" to "10.0.100-rc.1" to match the version specified in global.json:

{
  "sdk": {
    "version": "10.0.100-rc.1.25451.107"
  }
}

Target Framework

Updated the output path from net6.0 to net10.0 to reflect the current TargetFramework specified in PowerShell.Common.props:

  • Old: ./src/powershell-unix/bin/Debug/net6.0/linux-x64/publish/pwsh
  • New: ./src/powershell-unix/bin/Debug/net10.0/linux-x64/publish/pwsh

Bootstrap Process

  • Added the mandatory -Scenario Both parameter to the Start-PSBootstrap command, as required by the function signature in build.psm1
  • Removed outdated references to LLVM package feed (no longer used in current CI)
  • Simplified the bootstrap function description to accurately reflect current behavior
  • Updated to describe current process: installing dependencies and packaging tools, then downloading the .NET SDK

Spelling Dictionary

Added "net10.0" to the .spelling file to prevent spell-check warnings for the new framework version reference.

Verification

All changes were verified against:

  • .github/workflows/linux-ci.yml - CI workflow configuration
  • global.json - .NET SDK version
  • PowerShell.Common.props - Target framework version
  • build.psm1 - Bootstrap function implementation

Fixes #issue_number

Original prompt

Update the document, docs/building/linux.md, where it is out of date.
Look at the linux-ci workflow for how we are currently building.


💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

Copilot AI and others added 2 commits October 20, 2025 22:53
…mework

Co-authored-by: TravisEz13 <10873629+TravisEz13@users.noreply.github.com>
Co-authored-by: TravisEz13 <10873629+TravisEz13@users.noreply.github.com>
Copilot AI changed the title [WIP] Update linux.md documentation for current build process Update linux.md documentation to reflect current CI build configuration Oct 20, 2025
Copilot AI requested a review from TravisEz13 October 20, 2025 22:57
Comment thread docs/building/linux.md Outdated
Co-authored-by: TravisEz13 <10873629+TravisEz13@users.noreply.github.com>
@TravisEz13 TravisEz13 marked this pull request as ready for review October 21, 2025 19:46
Copilot AI review requested due to automatic review settings October 21, 2025 19:46

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull Request Overview

This PR updates the Linux build documentation to align with the current CI configuration and codebase state. The changes ensure developers following the documentation will use the same build environment and tools as the automated CI pipeline.

Key changes:

  • Updated Ubuntu version from 16.04 LTS to 24.04 LTS to match the CI's ubuntu-latest
  • Updated .NET SDK version from 2.0.0 to 10.0.100-rc.1 to match global.json
  • Updated target framework from net6.0 to net10.0 in build output paths

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
docs/building/linux.md Updated Ubuntu version, .NET SDK version, target framework path, bootstrap command parameters, and simplified bootstrap process description
.spelling Added net10.0 to prevent spell-check warnings for the new framework version

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@TravisEz13 TravisEz13 added the CL-Docs Indicates that a PR should be marked as a documentation change in the Change Log label Oct 21, 2025
@TravisEz13 TravisEz13 enabled auto-merge (squash) October 21, 2025 19:48
@TravisEz13 TravisEz13 merged commit 67a34a8 into master Oct 21, 2025
32 of 36 checks passed
@microsoft-github-policy-service

microsoft-github-policy-service Bot commented Oct 21, 2025

Copy link
Copy Markdown
Contributor

📣 Hey @@Copilot, how did we do? We would love to hear your feedback with the link below! 🗣️

🔗 https://aka.ms/PSRepoFeedback

SIRMARGIN pushed a commit to SIRMARGIN/PowerShell that referenced this pull request Dec 12, 2025
…on (PowerShell#26255)

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: TravisEz13 <10873629+TravisEz13@users.noreply.github.com>
kilasuit pushed a commit to kilasuit/PowerShell that referenced this pull request Jan 2, 2026
…on (PowerShell#26255)

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: TravisEz13 <10873629+TravisEz13@users.noreply.github.com>
@jshigetomi jshigetomi deleted the copilot/update-linux-documentation branch April 21, 2026 23:56
JustinGrote pushed a commit to JustinGrote/PowerShell that referenced this pull request Jun 2, 2026
…on (PowerShell#26255)

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: TravisEz13 <10873629+TravisEz13@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CL-Docs Indicates that a PR should be marked as a documentation change in the Change Log

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants