MicrosoftDocs / PowerShell-Docs

The official PowerShell documentation sources
https://learn.microsoft.com/powershell
Other
1.96k stars 1.56k forks source link

Is Find-DscResource really part of DSC? #1579

Closed zjalexander closed 6 years ago

zjalexander commented 7 years ago

Issue Details

Find-DscResource returns 2 results on Docs.microsoft.com:

  1. https://github.com/PowerShell/PowerShell-Docs/blob/live/reference/5.0/PowershellGet/Find-DscResource.md
  2. https://github.com/PowerShell/PowerShell-Docs/blob/live/reference/5.0/PSDesiredStateConfiguration/Find-DscResource.md

However, when I run

get-command find-dscresource
CommandType     Name                                               Version    Source
-----------     ----                                               -------    ------
Function        Find-DscResource                                   1.0.0.1    PowerShellGet

Pretty sure it's not part of PsDesiredStateConfiguration, so I propose removing item (2) and all references to it from the repo. cc: @grayzu @juanpablojofre @eslesar @JKeithB

Version(s) of document impacted

Reason(s) for not selecting all version of documents

zjalexander commented 7 years ago

Yup, definitely part of PSGet. Need to remove the PSDSC find-dscresource file.

ghost commented 7 years ago

Recommendation: It's probably good to have a reference in the DSC section, just point to the PSGet docs rather than duplicating them.

sdwheeler commented 6 years ago

@zjalexander @JKeithB - I am not sure what this issue is about. I don't see Find-DSCResource in the DSC docset. I only see it in the PowerShellGet docset. Is this still a valid issue?

ghost commented 6 years ago

Go ahead and remove any reference in DSC. It's causing confusion.

sdwheeler commented 6 years ago

@JKeithB - what do you mean by "reference in DSC"? Are you talking about the related links?

ghost commented 6 years ago

@sdwheeler please read the issue that was filed originally. Mark Gray's solution is needed.

sdwheeler commented 6 years ago

OK, I figured out what is needed here. Part of my confusion is that Find-DSCResource.md exists in reference\5.0\PSDesiredStateConfiguration but does not show up in the published web content for DSC. So I thought this was a non-issue. I will remove the file from reference\5.0\PSDesiredStateConfiguration.