Skip to content

Commit

Permalink
[Utilities] Implemented several improvments for readme script (#4134)
Browse files Browse the repository at this point in the history
* First readme update

* tested changes

* Remvoed file deletion

* Added URL test retry

* Added support for orphaned & moved readmes

* Ran readme utility
  • Loading branch information
AlexanderSehr authored Oct 22, 2023
1 parent 4ceedd1 commit 29b06f4
Show file tree
Hide file tree
Showing 8 changed files with 206 additions and 336 deletions.
2 changes: 2 additions & 0 deletions modules/compute/ssh-public-key/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Public SSH Keys `[Microsoft.Compute/sshPublicKeys]`

> This module has already been migrated to [AVM](https://github.com/Azure/bicep-registry-modules/tree/main/avm/res). Only the AVM version is expected to receive updates / new features. Please do not work on improving this module in [CARML](https://aka.ms/carml).
This module deploys a Public SSH Key.

> Note: The resource does not auto-generate the key for you.
Expand Down
2 changes: 2 additions & 0 deletions modules/key-vault/vault/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Key Vaults `[Microsoft.KeyVault/vaults]`

> This module has already been migrated to [AVM](https://github.com/Azure/bicep-registry-modules/tree/main/avm/res). Only the AVM version is expected to receive updates / new features. Please do not work on improving this module in [CARML](https://aka.ms/carml).
This module deploys a Key Vault.

## Navigation
Expand Down
2 changes: 2 additions & 0 deletions modules/kubernetes-configuration/extension/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Kubernetes Configuration Extensions `[Microsoft.KubernetesConfiguration/extensions]`

> This module has already been migrated to [AVM](https://github.com/Azure/bicep-registry-modules/tree/main/avm/res). Only the AVM version is expected to receive updates / new features. Please do not work on improving this module in [CARML](https://aka.ms/carml).
This module deploys a Kubernetes Configuration Extension.

## Navigation
Expand Down
2 changes: 2 additions & 0 deletions modules/kubernetes-configuration/flux-configuration/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Kubernetes Configuration Flux Configurations `[Microsoft.KubernetesConfiguration/fluxConfigurations]`

> This module has already been migrated to [AVM](https://github.com/Azure/bicep-registry-modules/tree/main/avm/res). Only the AVM version is expected to receive updates / new features. Please do not work on improving this module in [CARML](https://aka.ms/carml).
This module deploys a Kubernetes Configuration Flux Configuration.

## Navigation
Expand Down
2 changes: 2 additions & 0 deletions modules/network/private-endpoint/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Private Endpoints `[Microsoft.Network/privateEndpoints]`

> This module has already been migrated to [AVM](https://github.com/Azure/bicep-registry-modules/tree/main/avm/res). Only the AVM version is expected to receive updates / new features. Please do not work on improving this module in [CARML](https://aka.ms/carml).
This module deploys a Private Endpoint.

## Navigation
Expand Down
2 changes: 2 additions & 0 deletions modules/network/public-ip-address/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Public IP Addresses `[Microsoft.Network/publicIPAddresses]`

> This module has already been migrated to [AVM](https://github.com/Azure/bicep-registry-modules/tree/main/avm/res). Only the AVM version is expected to receive updates / new features. Please do not work on improving this module in [CARML](https://aka.ms/carml).
This module deploys a Public IP Address.

## Navigation
Expand Down
528 changes: 193 additions & 335 deletions utilities/pipelines/sharedScripts/Set-ModuleReadMe.ps1

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion utilities/tools/Set-Module.ps1
Original file line number Diff line number Diff line change
Expand Up @@ -132,11 +132,11 @@ function Set-Module {
################
if (-not $using:SkipReadMe) {
Write-Output "Generating readme for [$resourceTypeIdentifier]"
. $using:ReadMeScriptFilePath

# If the template was just build, we can pass the JSON into the readme script to be more efficient
$readmeTemplateFilePath = (-not $using:SkipBuild) ? (Join-Path (Split-Path $_ -Parent) 'main.json') : $_

. $using:ReadMeScriptFilePath
Set-ModuleReadMe -TemplateFilePath $readmeTemplateFilePath -CrossReferencedModuleList $using:crossReferencedModuleList
}
}
Expand Down

0 comments on commit 29b06f4

Please sign in to comment.