Skip to content

Conversation

@jeffkl
Copy link
Contributor

@jeffkl jeffkl commented Oct 28, 2025

This makes it a lot easier for me to edit docs and is entirely optional for people interacting with this repo

image

@jeffkl jeffkl self-assigned this Oct 28, 2025
@jeffkl jeffkl requested a review from a team as a code owner October 28, 2025 16:45
Copilot AI review requested due to automatic review settings October 28, 2025 16:45
@jeffkl jeffkl requested a review from a team as a code owner October 28, 2025 16:45
Copy link
Contributor

Copilot AI left a comment

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 adds Visual Studio solution and project files to enable easier documentation editing in Visual Studio. The changes introduce a no-targets MSBuild project that allows the documentation files to be browsed and edited through Visual Studio's Solution Explorer.

Key Changes:

  • Added a global.json file specifying the Microsoft.Build.NoTargets SDK version
  • Created a docs.csproj project file using the NoTargets SDK targeting .NET Framework 4.7.2
  • Created a docs.sln solution file that includes the docs project and common repository files

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File Description
global.json Specifies the Microsoft.Build.NoTargets SDK version for the project
docs/docs.csproj Defines a no-targets project for organizing documentation files in Visual Studio
docs.sln Solution file that references the docs project and includes relevant repository files in Solution Items

@learn-build-service-prod
Copy link

Learn Build status updates of commit 29e6f28:

✅ Validation status: passed

File Status Preview URL Details
docs.sln ✅Succeeded
docs/docs.csproj ✅Succeeded
global.json ✅Succeeded

For more details, please refer to the build report.

@learn-build-service-prod
Copy link

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

Co-authored-by: Copilot <[email protected]>
@learn-build-service-prod
Copy link

Learn Build status updates of commit 2f5eaa3:

✅ Validation status: passed

File Status Preview URL Details
docs.sln ✅Succeeded
docs/docs.csproj ✅Succeeded
global.json ✅Succeeded

For more details, please refer to the build report.

@learn-build-service-prod
Copy link

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

Copy link
Contributor

@donnie-msft donnie-msft left a comment

Choose a reason for hiding this comment

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

Interesting. I've never thought about building the docs repo locally. Could you share an example of what this will make easier?

@jeffkl
Copy link
Contributor Author

jeffkl commented Oct 28, 2025

Unfortunately, this does not make it so you can "build" the docs locally. You can build in VS but it doesn't really do anything. The main point of this is to load everything up in Visual Studio so you can browse the files, open them, search, etc.

I spent a few minutes seeing if there was a way to run the OpenPublishing stuff locally but couldn't find any info so I didn't pursue it further.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants