-
Notifications
You must be signed in to change notification settings - Fork 35
(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
(DOCS) Update CLI reference and conceptual docs for v3.0.0 #672
Conversation
8322bb9
to
84a9cd8
Compare
69f79fe
to
18a2eee
Compare
--------------------------------------------------------------- | ||
DesiredStateConfiguration-Preview 9PCX3HX4HZ0Z Unknown msstore | ||
``` | ||
|
There was a problem hiding this comment.
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 eithermsstore
orwinget
as the source. When usingwinget
, it leverages the.zip
file, whereasmsstore
uses the.msixbundle
.
18a2eee
to
690ae7e
Compare
690ae7e
to
de65bee
Compare
There was a problem hiding this 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
There was a problem hiding this 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.
2073abd
to
4f7cbac
Compare
|
||
## export | ||
|
||
A resource with the `export` capability supports enumerating every instance of the resource with |
There was a problem hiding this comment.
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.
There was a problem hiding this comment.
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?
There was a problem hiding this comment.
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
2fd0aea
to
939b321
Compare
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]>
939b321
to
ae29420
Compare
There was a problem hiding this 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 :)
PR Summary
This changeset updates and adds reference documentation for the
3.0.0
GA release of DSC.It includes:
Deferred to future PRs:
PR Context