Skip to content

Update docs#2362

Merged
manodasanW merged 8 commits intostaging/3.0from
manodasanw/docsUpdate3.0
Mar 22, 2026
Merged

Update docs#2362
manodasanW merged 8 commits intostaging/3.0from
manodasanw/docsUpdate3.0

Conversation

@manodasanW
Copy link
Copy Markdown
Member

No description provided.

Comment thread docs/interop.md Outdated
Comment thread docs/structure.md
@@ -13,15 +13,15 @@ Contains files that assist with publishing to Maestro.

## [`nuget`](../nuget)
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I feel like this whole document is unnecessary and should just be removed. The copilot instruction docs have the same info and much more in detail, and we also have a skill to auto-update them whenever needed.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

This doc doesn't need to be in detail but I think could be useful for someone looking at the repo for the first time and I think we should keep both docs for its own purpose rather than having folks read the other.

Comment thread docs/usage.md
@@ -2,56 +2,146 @@

The [C#/WinRT NuGet package](https://www.nuget.org/packages/Microsoft.Windows.CsWinRT/) provides tooling for the following scenarios:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

A bunch of stuff in this doc is also duplicate with what's in the copilot instruction and in the interop generator skill. I think we should keep this strictly just for docs for people on how to actually use the package and generate a projection, and skip repeating how the various tools work. We could just add a link to those two copilot docs instead and say to go read those if more info on the technical details is needed.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

I agree we should keep this doc to what consumers will run into. I did end up including WinRT.Projection and WinRT.Interop and bit of those details as folks will see it in their bin folder and may wonder what it is and if they should be distributing it in the case of published libraries and unpackaged apps. And also because folks are potentially going to get errors from those tools and we want them to be able know what they are reporting issues on.

@manodasanW manodasanW enabled auto-merge (squash) March 22, 2026 00:24
@manodasanW manodasanW merged commit 716eeb5 into staging/3.0 Mar 22, 2026
11 checks passed
@Sergio0694 Sergio0694 deleted the manodasanw/docsUpdate3.0 branch March 22, 2026 19:33
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.

2 participants