AzureDevOpsDsc: Increase Azure DevOps API timeout and other minor fixes (fixes #5, #10, #11, #12 and #25)

[SphenicPaul]

Pull Request (PR) description

Includes a number of minor fixes to close some small/minor issues:

• Increased the default, Azure DevOps API, timeout returned by Get-AzDevOpsApiWaitTimeoutMs to 300000 (5 minutes). Also increased related, parameter validation ranges within Test-AzDevOpsApiTimeoutExceeded, Wait-AzDevOpsApiResource and Wait-AzDevOpsApiOperation functions (fixes AzDevOpsProject: Integration tests fails intermittently with timeout error #25).
• Updated contextual help (fixes AzureDevOpsDsc: The module conceptual help is not complete #5).
• Removed the Classes and Examples directories from the build.yaml so they don't get copied into the module output (fixes AzureDevOpsDsc: Built module contain folder 'Classes' #10 and AzureDevOpsDsc: Built module contain folder 'Examples' #11).
• Moved 'Ensure' and 'RequiredAction' enums into 'Enum' directory and out of
  'prefix.ps1' (fixes AzureDevOpsDsc: Enums should move out of prefix file #12)

This Pull Request (PR) fixes the following issues

• Fixes AzureDevOpsDsc: The module conceptual help is not complete #5
• Fixes AzureDevOpsDsc: Built module contain folder 'Classes' #10
• Fixes AzureDevOpsDsc: Built module contain folder 'Examples' #11
• Fixes AzureDevOpsDsc: Enums should move out of prefix file #12
• Fixes AzDevOpsProject: Integration tests fails intermittently with timeout error #25

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 

[SphenicPaul]

@johlju - Shout if you've any questions with this. Nothing too major within these changes.

The integration tests ran OK locally against my Azure DevOps instance so I'd expect them to run OK when merged. Additionally, the API timeout is now 5 minutes so that should resolve the intermittent, integration failures.

I might look at the SQL Server (2019) and Azure DevOps Server (2020) installs (on build server as part of integration tests) for the next PR.

[johlju]

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

a discussion (no related file):
Now that we are fixing enums, can we remove these?

AzureDevOpsDsc/source/Classes/003.AzDevOpsDscResourceBase.ps1

Lines 1 to 6 in 48e919e

	# This enum is re-defined here so it is recognised by 'Import-DscResource' (which won't pre/post-parse the 'using' statements)
	#enum Ensure
	#{
	# Present
	# Absent
	#}

---

[SphenicPaul]

Reviewable status: 12 of 16 files reviewed, 1 unresolved discussion (waiting on @johlju)

a discussion (no related file):

Previously, johlju (Johan Ljunggren) wrote…

Now that we are fixing enums, can we remove these?

AzureDevOpsDsc/source/Classes/003.AzDevOpsDscResourceBase.ps1

Lines 1 to 6 in 48e919e

	# This enum is re-defined here so it is recognised by 'Import-DscResource' (which won't pre/post-parse the 'using' statements)
	#enum Ensure
	#{
	# Present
	# Absent
	#}

Done.

I've added some comments/properties on the three, base classes also.

---

[SphenicPaul]

Reviewable status: 12 of 16 files reviewed, 1 unresolved discussion (waiting on @johlju)

a discussion (no related file):

Previously, SphenicPaul (Paul J. Wilcox) wrote…

Done.

I've added some comments/properties on the three, base classes also.

...and also added comments/headers for the AzDevOpsProjectclass/resource.

---

[johlju]

Reviewed 4 of 4 files at r2.
Reviewable status: complete! all files reviewed, all discussions resolved (waiting on @SphenicPaul)