Skip to content

Update repo files ready for refactor#39

Merged
johlju merged 10 commits into
dsccommunity:mainfrom
dan-hughes:repo-updates
Nov 17, 2024
Merged

Update repo files ready for refactor#39
johlju merged 10 commits into
dsccommunity:mainfrom
dan-hughes:repo-updates

Conversation

@dan-hughes
Copy link
Copy Markdown
Contributor

@dan-hughes dan-hughes commented Nov 16, 2024

Pull Request (PR) description

Update the repository files to prepare for the larger changes coming.

This Pull Request (PR) fixes the following issues

Task list

  • Added an entry to the change log under the Unreleased section of the
    file CHANGELOG.md. Entry should say what was changed and how that
    affects users (if applicable), and reference the issue being resolved
    (if applicable).
  • Resource documentation updated in the resource's README.md.
  • Resource parameter descriptions updated in schema.mof.
  • Comment-based help updated, including parameter descriptions.
  • Localization strings updated.
  • Examples updated.
  • Unit tests updated. See DSC Community Testing Guidelines.
  • Integration tests updated (where possible). See DSC Community Testing Guidelines.
  • Code changes adheres to DSC Community Style Guidelines.

This change is Reviewable

@johlju
Copy link
Copy Markdown
Member

johlju commented Nov 17, 2024

FYI. I'm gonna switch the default branch back to main otherwise the pipeline wont work. Having another branch is gonna be a pain and just add even more maintenance.

@johlju johlju changed the base branch from prerelease to main November 17, 2024 08:49
@dan-hughes
Copy link
Copy Markdown
Contributor Author

I was going to ask why build was not triggering.

Where is best to discuss this module as a whole? With the changes in #37, it would be good to try and unpick that into smaller PR's.

@johlju
Copy link
Copy Markdown
Member

johlju commented Nov 17, 2024

Best would to discuss it in the PR that suggest changes, as those interested in the module can have an opinion. 🤔 But the PR has been worked on for a long time without anyone in community that is using the module has raised any concerns or suggestions, so a few weeks back I assumed it is a general good change and would have just merged it. 🤔

@dan-hughes
Copy link
Copy Markdown
Contributor Author

It's a pretty large change and most of the tests are not using the dsccommunity conventions or tasks.

I'm not sure how much the module is being used either, I can't find it in the PSGallery.

Any reason you can see for why azure pipelines are not running?

@johlju
Copy link
Copy Markdown
Member

johlju commented Nov 17, 2024

/azp run

@azure-pipelines
Copy link
Copy Markdown

Azure Pipelines failed to run 1 pipeline(s).

@johlju
Copy link
Copy Markdown
Member

johlju commented Nov 17, 2024

It says

/azure-pipelines.yml (Line: 278, Col: 17): While parsing a block mapping, did not find expected key.
9724

@dan-hughes
Copy link
Copy Markdown
Contributor Author

Just seen it.

@johlju
Copy link
Copy Markdown
Member

johlju commented Nov 17, 2024

It's a pretty large change and most of the tests are not using the dsccommunity conventions or tasks.

Maybe split it up with just one DSC resource with all necessary helper code to make it run so that can be reviewed first. 🤔

I'm not sure how much the module is being used either, I can't find it in the PSGallery.

There are no releases or tags in the repo so my guess it has never been used since until recently there was not a pipeline added, and no changes to source after it was added that would have triggered a preview build.

@johlju
Copy link
Copy Markdown
Member

johlju commented Nov 17, 2024

Suggest removing the Linux, macOS and PS Core unit tests, let us assume this will be used in Windows only until another PR introduces something else? 🤔

@dan-hughes
Copy link
Copy Markdown
Contributor Author

It's a pretty large change and most of the tests are not using the dsccommunity conventions or tasks.

Maybe split it up with just one DSC resource with all necessary helper code to make it run so that can be reviewed first. 🤔

That's my initial thought, use it to get CI to pass then it will be much easier for future PR's.

I'm not sure how much the module is being used either, I can't find it in the PSGallery.

There are no releases or tags in the repo so my guess it has never been used since until recently there was not a pipeline added, and no changes to source after it was added that would have triggered a preview build.

That makes sense.

@dan-hughes
Copy link
Copy Markdown
Contributor Author

Waiting on dsccommunity/DscResource.Common#134 for HQRM to pass.

Copy link
Copy Markdown
Member

@johlju johlju left a comment

Choose a reason for hiding this comment

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

Reviewable status: 0 of 71 files reviewed, 1 unresolved discussion (waiting on @dan-hughes)


build.yaml line 115 at r4 (raw file):

  ExcludeSourceFile:
    - output
  ExcludeModuleFile:

We should add - Modules/DscResource.Common to exclude and modules that is not part of source in the built moduled

@dan-hughes
Copy link
Copy Markdown
Contributor Author

Reviewable status: 0 of 71 files reviewed, 1 unresolved discussion (waiting on @dan-hughes)

build.yaml line 115 at r4 (raw file):

  ExcludeSourceFile:
    - output
  ExcludeModuleFile:

We should add - Modules/DscResource.Common to exclude and modules that is not part of source in the built moduled

Yes. I've disabled Integration tests for the time being.

Just need to fix code coverage merging.

@codecov
Copy link
Copy Markdown

codecov Bot commented Nov 17, 2024

Welcome to Codecov 🎉

Once you merge this PR into your default branch, you're all set! Codecov will compare coverage reports and display results in all future pull requests.

Thanks for integrating Codecov - We've got you covered ☂️

@dan-hughes
Copy link
Copy Markdown
Contributor Author

dan-hughes commented Nov 17, 2024

@johlju, this should also be green when it finishes.

Next steps, pick a resource out of the other PR and add the minimum files. But not in this PR.

@dan-hughes dan-hughes marked this pull request as ready for review November 17, 2024 16:11
Copy link
Copy Markdown
Member

@johlju johlju left a comment

Choose a reason for hiding this comment

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

:lgtm:

Reviewed 50 of 70 files at r1, 19 of 19 files at r3, 1 of 2 files at r6, 1 of 1 files at r7, all commit messages.
Reviewable status: all files reviewed, 1 unresolved discussion (waiting on @dan-hughes)


.devcontainer/devcontainer.json line 4 at r7 (raw file):

// README at: https://github.com/devcontainers/templates/tree/main/src/powershell
{
	"name": "PowerShell",

Looks like tabs in this file.

@johlju
Copy link
Copy Markdown
Member

johlju commented Nov 17, 2024

Can you check the tabs in the file (see comment), then I merge it.

@dan-hughes
Copy link
Copy Markdown
Contributor Author

Can you check the tabs in the file (see comment), then I merge it.

As in convert it to spaces? Not sure why it did that.

@johlju
Copy link
Copy Markdown
Member

johlju commented Nov 17, 2024

Can you check the tabs in the file (see comment), then I merge it.

As in convert it to spaces? Not sure why it did that.

Exactly, convert to spaces if possible.

@dan-hughes
Copy link
Copy Markdown
Contributor Author

Can you check the tabs in the file (see comment), then I merge it.

As in convert it to spaces? Not sure why it did that.

Exactly, convert to spaces if possible.

Done.

@johlju johlju merged commit bd9ab0d into dsccommunity:main Nov 17, 2024
@dan-hughes dan-hughes deleted the repo-updates branch November 17, 2024 17:44
ZanattaMichael added a commit to ZanattaMichael/AzureDevOpsDsc that referenced this pull request May 22, 2026
…ncy management (#18)

* Fix pipeline

* Workaround bug in AzDevOpProject resource

* Fix pinning GitVersion to v5

* Update repo files ready for refactor (dsccommunity#39)

* Update resource documentation for accuracy and completeness

- README: add Resources table with links to all 8 DSC resource docs
- AzDoGitPermission.md: fix wrong Ensure default ('Absent'→'Present'), fix wrong Additional Information text (copy-paste from AzDoProject)
- AzDoGitRepository.md: fix wrong Ensure default ('Absent'→'Present')
- AzDoGroupMember.md: add missing Ensure to syntax block and Properties section
- AzDoOrganizationGroup.md: fix wrong resource name in Example 2 comment, add missing Ensure to syntax and Properties, add missing closing code fence
- AzDoProject.md: fix ProjectDiscription typo→ProjectDescription, fix MySameProject→MySampleProject
- AzDoProjectGroup.md: add missing Ensure to syntax block and Properties section
- AzDoProjectServices.md: add missing Ensure to syntax block and Properties section
- AzDoGroupPermission.md: remove internal implementation method code (not user-facing docs)

#18

---------

Co-authored-by: Johan Ljunggren <johlju@users.noreply.github.com>
Co-authored-by: Daniel Hughes <2237515+dan-hughes@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
ZanattaMichael pushed a commit to ZanattaMichael/AzureDevOpsDsc that referenced this pull request May 22, 2026
Brings in 5 upstream commits:
- Update README with maintenance status and recommendations
- Update repo files ready for refactor (dsccommunity#39)
- Fix pinning GitVersion to v5
- Workaround bug in AzDevOpProject resource
- Fix pipeline

Conflict resolutions:
- source/AzureDevOpsDsc.psd1: kept fork's moduleVersion (0.0.2),
  PowerShellVersion (7.0), and full DscResourcesToExport list; adopted
  upstream's explicit FunctionsToExport/CmdletsToExport format
- CHANGELOG.md: merged both sides' Added and Changed entries
- .devcontainer/devcontainer.json: kept upstream's space-indented format
  (functionally identical to fork's tab-indented version)
- tests/Unit/Classes/** (18 UU conflicts): took fork's version — the fork
  deliberately removed the 'using module' preamble and InModuleScope wrapper
  in its test restructure
- 23 DU (modify/delete) test files: kept fork's deletion — these old test
  files were reorganized/replaced in the fork's test restructure

https://claude.ai/code/session_01UbbFoPzqDhPfU33zHW8Pwf
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.

2 participants