Skip to content

BREAKING CHANGE: xWebSiteDefaults: Align to best practices - #527

Merged
johlju merged 1 commit into
dsccommunity:devfrom
RandomNoun7:ghissues/457
Oct 7, 2019
Merged

BREAKING CHANGE: xWebSiteDefaults: Align to best practices#527
johlju merged 1 commit into
dsccommunity:devfrom
RandomNoun7:ghissues/457

Conversation

@RandomNoun7

@RandomNoun7 RandomNoun7 commented Oct 6, 2019

Copy link
Copy Markdown
Contributor

This change brings the modules xWebSiteDefaults resource into
alignment with best practices for single instance resources.

When defining a resource that should only be allowed to be defined once
in any configuration, there are now best practices for how to implement
that restriction. There should be a single key property and its name
should be 'IsSingleInstance' with a value of 'Yes'. This change
implements that best practice.

Fixes #457

[x] Added an entry to the change log under the Unreleased section of the CHANGELOG.md.
Entry should say what was changed and how that affects users (if applicable), and
reference the issue being resolved (if applicable).
[x] Resource documentation added/updated in README.md.
[x] Resource parameter descriptions added/updated in README.md, schema.mof
and comment-based help.
[ ] Comment-based help added/updated.
[ ] Localization strings added/updated in all localization files as appropriate.
[x] Examples appropriately added/updated.
[ ] Unit tests added/updated. See DSC Resource Testing Guidelines.
[x] Integration tests added/updated (where possible). See DSC Resource Testing Guidelines.
[x] New/changed code adheres to DSC Resource Style Guidelines and Best Practices.


This change is Reviewable

@codecov-io

codecov-io commented Oct 6, 2019

Copy link
Copy Markdown

Codecov Report

Merging #527 into dev will not change coverage.
The diff coverage is 0%.

Impacted file tree graph

@@           Coverage Diff           @@
##              dev     #527   +/-   ##
=======================================
  Coverage   91.39%   91.39%           
=======================================
  Files          17       17           
  Lines        2661     2661           
=======================================
  Hits         2432     2432           
  Misses        229      229
Impacted Files Coverage Δ
...s/MSFT_xWebSiteDefaults/MSFT_xWebSiteDefaults.psm1 12.5% <0%> (ø) ⬆️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 7e1535d...67c52d4. Read the comment docs.

@johlju johlju added needs review The pull request needs a code review. breaking change When used on an issue, the issue has been determined to be a breaking change. labels Oct 7, 2019

@johlju johlju left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Reviewed 7 of 8 files at r1.
Reviewable status: 7 of 8 files reviewed, all discussions resolved

@johlju

johlju commented Oct 7, 2019

Copy link
Copy Markdown
Member

Waiting to merge another PR before this one (waiting for the tests to pass). That PR might affect the change log entry in this PR.

@RandomNoun7

Copy link
Copy Markdown
Contributor Author

@johlju Ok. Just ping me in a comment when ready and I'll rebase this one.

@johlju

johlju commented Oct 7, 2019

Copy link
Copy Markdown
Member

@RandomNoun7 will be in just a few minutes.

@johlju johlju left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Ready to rebase! 😃

Reviewed 1 of 8 files at r1.
Reviewable status: all files reviewed, 1 unresolved discussion (waiting on @RandomNoun7)


CHANGELOG.md, line 54 at r1 (raw file):

 Changes to xWebSiteDefaults

When you rebase there will be an - Changes to xWebSiteDefaults where this entry can go under.

@johlju johlju added waiting for code fix A review left open comments, and the pull request is waiting for changes to be pushed by the author. and removed needs review The pull request needs a code review. labels Oct 7, 2019
This change brings the modules xWebSiteDefaults resource into
alignment with best practices for single instance resources.

When defining a resource that should only be allowed to be defined once
in any configuration, there are now best practices for how to implement
that restriction. There should be a single key property and its name
should be 'IsSingleInstance' with a value of 'Yes'. This change
implements that best practice.

Fixes dsccommunity#457

[x] Added an entry to the change log under the Unreleased section of the CHANGELOG.md.
Entry should say what was changed and how that affects users (if applicable), and
reference the issue being resolved (if applicable).
[x] Resource documentation added/updated in README.md.
[x] Resource parameter descriptions added/updated in README.md, schema.mof
and comment-based help.
[ ] Comment-based help added/updated.
[ ] Localization strings added/updated in all localization files as appropriate.
[x] Examples appropriately added/updated.
[ ] Unit tests added/updated. See DSC Resource Testing Guidelines.
[x] Integration tests added/updated (where possible). See DSC Resource Testing Guidelines.
[x] New/changed code adheres to DSC Resource Style Guidelines and Best Practices.
@RandomNoun7

Copy link
Copy Markdown
Contributor Author

@johlju Rebase complete and pushed.

@johlju johlju left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

:lgtm:

Reviewed 3 of 3 files at r2.
Reviewable status: :shipit: complete! all files reviewed, all discussions resolved

@johlju johlju added ready for merge The pull request was approved by the community and is ready to be merged by a maintainer. and removed waiting for code fix A review left open comments, and the pull request is waiting for changes to be pushed by the author. labels Oct 7, 2019
@johlju

johlju commented Oct 7, 2019

Copy link
Copy Markdown
Member

Closing and reopening to kick off the tests. CI failed on unrelated issue.

@johlju johlju closed this Oct 7, 2019
@johlju johlju reopened this Oct 7, 2019
@johlju
johlju merged commit 0e06302 into dsccommunity:dev Oct 7, 2019
@johlju johlju removed the ready for merge The pull request was approved by the community and is ready to be merged by a maintainer. label Oct 7, 2019
@RandomNoun7
RandomNoun7 deleted the ghissues/457 branch October 8, 2019 14:00
gstorme pushed a commit to gstorme/xWebAdministration that referenced this pull request Feb 14, 2020
…ity#527)

- Changes to xWebSiteDefaults
  - BREAKING CHANGE: Changed `ApplyTo` key parameter to `IsSingleInstance` to
    bring the resource into compliance with published best practices (issue dsccommunity#457).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

breaking change When used on an issue, the issue has been determined to be a breaking change.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

xWebSiteDefaults: Should be made to follow the best practice for single instance resource

3 participants