-
Notifications
You must be signed in to change notification settings - Fork 19
Various Documentation Issues #7
Description
-
https://github.com/Microsoft/ConnectedServices/blob/v15.0/SDK/articles/AdvancedSeries.md
Page starts with this note:
Note: this section is just a beginning. as we develop more content, this will continue to evolve
(Yet, it was last updated on 7/16/15). -
Dead links:
PowerPoint template for mocking up your Connected Service provider (https://github.com/Microsoft/ConnectedServices/blob/v15.0/SDK/articles/articles/ConnectedServiceProviderAuthorMockups.pptx)
• Setting your Connected Service Extension Icon (https://github.com/Microsoft/ConnectedServices/blob/v15.0/SDK/articles/articles/ExtensionIcon.md) -
Sample:
https://github.com/Microsoft/ConnectedServices/blob/master/SDK/articles/CreatingAConnectedServiceExtension.md
Screenshots are all from VS2015 and the UI is different in 2017.
The screenshot is showing use of .NET 4.5.2 for a vsix project, but later we need to add the NuGet package for Microsoft.VisualStudio.ConnectedServices. This package only seems to work with 4.6. The documentation should really state what versions to target, and the screenshots need to be updated.
As the documentation is laid out, it has you first debugging, then adding the handler. This won't work - without the handler, debugging won't end up showing the connected service at all.
-
The "ConnectedServicesOverview" (https://github.com/Microsoft/ConnectedServices/blob/v15.0/SDK/articles/ConnectedServicesOverview.md) lists "Comming soon". Yes, it's misspelled, and last updated on 4/15/15.
-
Lack of details around installing NuGet packages. The documentation only says this is possible, but redirects us to http://docs.nuget.org/docs/reference/invoking-nuget-services-from-inside-visual-studio. That article is not sufficient to actually figure out how to get the connected service project to add a NuGet package. And the samples only use Thread.Sleep where it should be showing how to install a NuGet package.