Skip to content

(DOCS) Update CLI reference and conceptual docs for v3.0.0 #672

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

Conversation

michaeltlombardi
Copy link
Collaborator

@michaeltlombardi michaeltlombardi commented Mar 5, 2025

PR Summary

This changeset updates and adds reference documentation for the 3.0.0 GA release of DSC.

It includes:

  • Updated CLI reference
  • Updated and expanded documentation for concepts
  • Scaffold reference for built-in resources

Deferred to future PRs:

  • Reference docs for built-in resources
  • Updates to schema docs

PR Context

@michaeltlombardi michaeltlombardi changed the title (DOCS) Update reference docs for v3.0.0 (DOCS) Update CLI reference and conceptual docs for v3.0.0 Mar 17, 2025
@michaeltlombardi michaeltlombardi marked this pull request as ready for review March 17, 2025 22:15
---------------------------------------------------------------
DesiredStateConfiguration-Preview 9PCX3HX4HZ0Z Unknown msstore
```

Copy link
Contributor

Choose a reason for hiding this comment

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

Perhaps a small remark for the users telling something like:

[!INFO]
You can use either msstore or winget as the source. When using winget, it leverages the .zip file, whereas msstore uses the .msixbundle.

Copy link
Member

@SteveL-MSFT SteveL-MSFT left a comment

Choose a reason for hiding this comment

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

Will need more time to go through all the docs

Copy link
Member

@mgreenegit mgreenegit left a comment

Choose a reason for hiding this comment

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

This is such as massive PR, it will be easier to "nit pick" using small PRs after it is published. At a high level, everything looks good to me.
:shipit:


## export

A resource with the `export` capability supports enumerating every instance of the resource with
Copy link
Member

Choose a reason for hiding this comment

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

I think it's worth calling out that if no input is provided, expectation is all instances are returned, but if there is input, then that input should be used as a filter.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

This isn't currently implemented but it's the planned implementation, correct?

Copy link
Member

Choose a reason for hiding this comment

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

Input is passed to the resource on export if provided

michaeltlombardi and others added 4 commits May 1, 2025 08:39
Prior to this change, the docs folder didn't include any conceptual
documentation, only reference documents.

This change copies existing concept docs into the folder, updates them
for GA, and adds new conceptual documentation to make it easier for
new users to learn about DSC and start using it.
This change updates the reference docs for:

- `Microsoft/OSInfo` resource
- `osinfo` CLI tool
- `Microsoft.Windows/Registry` resource
- `registry` CLI tool

These are the only resources currently documented on
the live docs site.
Co-authored-by: Steve Lee <[email protected]>
Co-authored-by: Michael Greene <[email protected]>
@michaeltlombardi michaeltlombardi force-pushed the docs/main/v3-reference branch from 939b321 to ae29420 Compare May 1, 2025 13:39
Copy link
Member

@SteveL-MSFT SteveL-MSFT left a comment

Choose a reason for hiding this comment

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

Probably good enough for now :)

@SteveL-MSFT SteveL-MSFT added this pull request to the merge queue May 2, 2025
Merged via the queue into PowerShell:main with commit 8dc0655 May 2, 2025
1 check passed
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.

4 participants