Skip to content
This repository was archived by the owner on Dec 11, 2020. It is now read-only.
This repository was archived by the owner on Dec 11, 2020. It is now read-only.

Various Documentation Issues #7

@jamesosb-msft

Description

@jamesosb-msft
  1. 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).

  2. 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)

  3. 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.

  1. 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.

  2. 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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions