Skip to content

Commit 3eb3a27

Browse files
committed
Link to issue and tool repository
1 parent 115f77b commit 3eb3a27

File tree

1 file changed

+5
-9
lines changed

1 file changed

+5
-9
lines changed

accepted/2023/package-source-mapper-VS.md

+5-9
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,12 @@
22
<!-- Replace `Title` with an appropriate title for your design -->
33

44
- Donnie Goodson ([donnie-msft](https://github.com/donnie-msft))
5-
- GitHub Issue <!-- GitHub Issue link -->
5+
- GitHub Issue [#12834](https://github.com/NuGet/Home/issues/12834)
66

77
## Summary
88

99
<!-- One-paragraph description of the proposal. -->
10-
Package source mapping is a relatively new feature in the .NET ecosystem, and Visual Studio (VS) doesn't currently have an onboarding experience for existing solutions. Let's bring the `PackageSourceMapper` tool's functionality into Visual Studio by introducing a button to launch the tool via the `NuGet Package Manager` VS Options. The existing `Package Source Mappings` options page can be automatically populated by the tool, and then update the solution's `NuGet.Config` with all package's mapped to the appropriate source.
10+
Package source mapping is a relatively new feature in the .NET ecosystem, and Visual Studio (VS) doesn't currently have an onboarding experience for existing solutions. Let's bring the [PackageSourceMapper](https://github.com/NuGet/PackageSourceMapper/tree/dev/PackageSourceMapper) tool's functionality into Visual Studio by introducing a button to launch the tool via the `NuGet Package Manager` VS Options. The existing `Package Source Mappings` options page can be automatically populated by the tool, and then update the solution's `NuGet.Config` with all package's mapped to the appropriate source.
1111

1212
## Motivation
1313

@@ -25,7 +25,6 @@ Open a solution which has not onboarded to Package Source Mapping. Navigate to t
2525
If a solution is already onboarded, there will be at least 1 mapping already, and therefore, the link to onboard a solution will not be available.
2626

2727
Press the link, and a cancellable dialog window will appear indicating the following progress:
28-
1. Loading the `PackageSourceMapper` tool as an external process.
2928
1. The tool is reading the solution's package graph.
3029
1. The tool is calculating the source mappings to create.
3130
1. Results are shown in the dialog, and the Cancel button changes to an OK button.
@@ -38,12 +37,9 @@ Press the link, and a cancellable dialog window will appear indicating the follo
3837
### Technical explanation
3938

4039
<!-- Explain the proposal in sufficient detail with implementation details, interaction models, and clarification of corner cases. -->
41-
- `PackageSourceMapper` installation to VS
42-
- Optional component? Workload?
43-
- NuGet.Tools.vsix? Separate vsix?
44-
- External process initiated from VS
45-
- VS Option pages already use WPF dialogs which will be the UI to communicate this tool's state.
46-
- Populating the list gives the customer the ability to "consent" to the generated mappings prior to writing creating them. The heavy lifting is behind-the-scenes, but the impact is visible to the customer.
40+
- Import the relevant source code into VS from the [PackageSourceMapper](https://github.com/NuGet/PackageSourceMapper/tree/dev/PackageSourceMapper) repository.
41+
- VS Options dialog have pages that already use WPF dialogs, which will be the UI to communicate status from the tool.
42+
- Populating the list gives the customer the ability to "consent" to the generated mappings prior to writing them to disk. The heavy lifting is behind-the-scenes, but the impact is visible to the customer.
4743
- Writing to the `NuGet.Config` is functionality that's already available from NuGet's VS Option pages.
4844

4945
## Drawbacks

0 commit comments

Comments
 (0)