[powershell] cleanup documentation (#15355)

* [powershell] fix documentation of API authorization in README files

fix hierarchy level + add internal links + align wording across generators

* [powershell] fix anchor links in documentation

Author: tiffmaelite

modules/openapi-generator/src/main/resources/powershell/README.mustache

@@ -16,14 +16,14 @@ This PowerShell module is automatically generated by the [OpenAPI Generator](htt
     For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})
 {{/infoUrl}}
 
-<a name="frameworks-supported"></a>
+<a id="frameworks-supported"></a>
 ## Frameworks supported
 - PowerShell {{{powershellVersion}}} or later
 
-<a name="dependencies"></a>
+<a id="dependencies"></a>
 ## Dependencies
 
-<a name="installation"></a>
+<a id="installation"></a>
 ## Installation
 
 {{#powershellGalleryUrl}}
@@ -46,7 +46,7 @@ To uninstall the module, simply run:
 Remove-Module -FullyQualifiedName @{ModuleName = "{{{packageName}}}"; ModuleVersion = "{{{packageVersion}}}"}
 ```
 
-<a name="tests"></a>
+<a id="tests"></a>
 ## Tests
 
 To install and run `Pester`, please execute the following commands in the terminal:
@@ -78,18 +78,13 @@ Class | Method | HTTP request | Description
 No model defined in this package
 {{/modelPackage}}
 
+<a id="documentation-for-authorization"></a>
 ## Documentation for Authorization
 
-{{^authMethods}}
-All endpoints do not require authorization.
-{{/authMethods}}
-{{#authMethods}}
-{{#last}}
-Authentication schemes defined for the API:
-{{/last}}
-{{/authMethods}}
+{{^authMethods}}Endpoints do not require authorization.{{/authMethods}}
+{{#hasAuthMethods}}Authentication schemes defined for the API:{{/hasAuthMethods}}
 {{#authMethods}}
-
+<a id="{{name}}"></a>
 ### {{name}}
 
 {{#isApiKey}}- **Type**: API key

modules/openapi-generator/src/main/resources/powershell/api_doc.mustache

@@ -10,7 +10,7 @@ Method | HTTP request | Description
 
 {{#operations}}
 {{#operation}}
-<a name="{{{vendorExtensions.x-powershell-method-name-lowercase}}}"></a>
+<a id="{{{vendorExtensions.x-powershell-method-name-lowercase}}}"></a>
 # **{{{vendorExtensions.x-powershell-method-name}}}**
 > {{{returnType}}}{{^returnType}}void{{/returnType}} {{{vendorExtensions.x-powershell-method-name}}}<br>
 {{#allParams}}

samples/client/petstore/powershell/README.md

@@ -8,14 +8,14 @@ This PowerShell module is automatically generated by the [OpenAPI Generator](htt
 - SDK version: 0.1.2
 - Build package: org.openapitools.codegen.languages.PowerShellClientCodegen
 
-<a name="frameworks-supported"></a>
+<a id="frameworks-supported"></a>
 ## Frameworks supported
 - PowerShell 5.0 or later
 
-<a name="dependencies"></a>
+<a id="dependencies"></a>
 ## Dependencies
 
-<a name="installation"></a>
+<a id="installation"></a>
 ## Installation
 
 To install from PowerShell Gallery (https://www.powershellgallery.com/packages/PSPetstore)
@@ -36,7 +36,7 @@ To uninstall the module, simply run:
 Remove-Module -FullyQualifiedName @{ModuleName = "PSPetstore"; ModuleVersion = "0.1.2"}
 ```
 
-<a name="tests"></a>
+<a id="tests"></a>
 ## Tests
 
 To install and run `Pester`, please execute the following commands in the terminal:
@@ -174,9 +174,12 @@ Class | Method | HTTP request | Description
  - [PSPetstore/Model.Zebra](docs/Zebra.md)
 
 
+<a id="documentation-for-authorization"></a>
 ## Documentation for Authorization
 
 
+Authentication schemes defined for the API:
+<a id="petstore_auth"></a>
 ### petstore_auth
 
 
@@ -187,35 +190,35 @@ Class | Method | HTTP request | Description
   - write:pets: modify pets in your account
   - read:pets: read your pets
 
-
+<a id="api_key"></a>
 ### api_key
 
 - **Type**: API key
 
 - **API key parameter name**: api_key
 - **Location**: HTTP header
 
-
+<a id="api_key_query"></a>
 ### api_key_query
 
 - **Type**: API key
 
 - **API key parameter name**: api_key_query
 - **Location**: URL query string
 
-
+<a id="http_basic_test"></a>
 ### http_basic_test
 
 
 - **Type**: HTTP basic authentication
 
-
+<a id="bearer_test"></a>
 ### bearer_test
 
 
 - **Type**: HTTP basic authentication
 
-
+<a id="http_signature_test"></a>
 ### http_signature_test
 
 

samples/client/petstore/powershell/docs/PSAnotherFakeApi.md

@@ -7,7 +7,7 @@ Method | HTTP request | Description
 [**Invoke-PS123TestSpecialTags**](PSAnotherFakeApi.md#Invoke-PS123TestSpecialTags) | **PATCH** /another-fake/dummy | To test special tags
 
 
-<a name="Invoke-PS123TestSpecialTags"></a>
+<a id="Invoke-PS123TestSpecialTags"></a>
 # **Invoke-PS123TestSpecialTags**
 > Client Invoke-PS123TestSpecialTags<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-Client] <PSCustomObject><br>

samples/client/petstore/powershell/docs/PSDefaultApi.md

@@ -7,7 +7,7 @@ Method | HTTP request | Description
 [**Invoke-PSFooGet**](PSDefaultApi.md#Invoke-PSFooGet) | **GET** /foo | 
 
 
-<a name="Invoke-PSFooGet"></a>
+<a id="Invoke-PSFooGet"></a>
 # **Invoke-PSFooGet**
 > FooGetDefaultResponse Invoke-PSFooGet<br>
 

samples/client/petstore/powershell/docs/PSFakeApi.md

@@ -21,7 +21,7 @@ Method | HTTP request | Description
 [**Test-PSQueryParameterCollectionFormat**](PSFakeApi.md#Test-PSQueryParameterCollectionFormat) | **PUT** /fake/test-query-parameters | 
 
 
-<a name="Invoke-PSFakeHealthGet"></a>
+<a id="Invoke-PSFakeHealthGet"></a>
 # **Invoke-PSFakeHealthGet**
 > HealthCheckResult Invoke-PSFakeHealthGet<br>
 
@@ -57,7 +57,7 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Invoke-PSFakeOuterBooleanSerialize"></a>
+<a id="Invoke-PSFakeOuterBooleanSerialize"></a>
 # **Invoke-PSFakeOuterBooleanSerialize**
 > Boolean Invoke-PSFakeOuterBooleanSerialize<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-Body] <System.Nullable[Boolean]><br>
@@ -99,7 +99,7 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Invoke-PSFakeOuterCompositeSerialize"></a>
+<a id="Invoke-PSFakeOuterCompositeSerialize"></a>
 # **Invoke-PSFakeOuterCompositeSerialize**
 > OuterComposite Invoke-PSFakeOuterCompositeSerialize<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-OuterComposite] <PSCustomObject><br>
@@ -141,7 +141,7 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Invoke-PSFakeOuterNumberSerialize"></a>
+<a id="Invoke-PSFakeOuterNumberSerialize"></a>
 # **Invoke-PSFakeOuterNumberSerialize**
 > Decimal Invoke-PSFakeOuterNumberSerialize<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-Body] <System.Nullable[Decimal]><br>
@@ -183,7 +183,7 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Invoke-PSFakeOuterStringSerialize"></a>
+<a id="Invoke-PSFakeOuterStringSerialize"></a>
 # **Invoke-PSFakeOuterStringSerialize**
 > String Invoke-PSFakeOuterStringSerialize<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-Body] <String><br>
@@ -225,7 +225,7 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Get-PSArrayOfEnums"></a>
+<a id="Get-PSArrayOfEnums"></a>
 # **Get-PSArrayOfEnums**
 > OuterEnum[] Get-PSArrayOfEnums<br>
 
@@ -261,7 +261,7 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Test-PSBodyWithFileSchema"></a>
+<a id="Test-PSBodyWithFileSchema"></a>
 # **Test-PSBodyWithFileSchema**
 > void Test-PSBodyWithFileSchema<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-FileSchemaTestClass] <PSCustomObject><br>
@@ -304,7 +304,7 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Test-PSBodyWithQueryParams"></a>
+<a id="Test-PSBodyWithQueryParams"></a>
 # **Test-PSBodyWithQueryParams**
 > void Test-PSBodyWithQueryParams<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-Query] <String><br>
@@ -347,7 +347,7 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Test-PSClientModel"></a>
+<a id="Test-PSClientModel"></a>
 # **Test-PSClientModel**
 > Client Test-PSClientModel<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-Client] <PSCustomObject><br>
@@ -390,7 +390,7 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Test-PSEndpointParameters"></a>
+<a id="Test-PSEndpointParameters"></a>
 # **Test-PSEndpointParameters**
 > void Test-PSEndpointParameters<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-Number] <Decimal><br>
@@ -478,7 +478,7 @@ void (empty response body)
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Test-PSEnumParameters"></a>
+<a id="Test-PSEnumParameters"></a>
 # **Test-PSEnumParameters**
 > void Test-PSEnumParameters<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-EnumHeaderStringArray] <String[]><br>
@@ -542,7 +542,7 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Test-PSGroupParameters"></a>
+<a id="Test-PSGroupParameters"></a>
 # **Test-PSGroupParameters**
 > void Test-PSGroupParameters<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-RequiredStringGroup] <Int32><br>
@@ -606,7 +606,7 @@ void (empty response body)
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Test-PSInlineAdditionalProperties"></a>
+<a id="Test-PSInlineAdditionalProperties"></a>
 # **Test-PSInlineAdditionalProperties**
 > void Test-PSInlineAdditionalProperties<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-RequestBody] <System.Collections.Hashtable><br>
@@ -649,7 +649,7 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Test-PSJsonFormData"></a>
+<a id="Test-PSJsonFormData"></a>
 # **Test-PSJsonFormData**
 > void Test-PSJsonFormData<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-Param] <String><br>
@@ -695,7 +695,7 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Test-PSQueryParameterCollectionFormat"></a>
+<a id="Test-PSQueryParameterCollectionFormat"></a>
 # **Test-PSQueryParameterCollectionFormat**
 > void Test-PSQueryParameterCollectionFormat<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-Pipe] <String[]><br>

samples/client/petstore/powershell/docs/PSFakeClassnameTags123Api.md

@@ -7,7 +7,7 @@ Method | HTTP request | Description
 [**Test-PSClassname**](PSFakeClassnameTags123Api.md#Test-PSClassname) | **PATCH** /fake_classname_test | To test class name in snake case
 
 
-<a name="Test-PSClassname"></a>
+<a id="Test-PSClassname"></a>
 # **Test-PSClassname**
 > Client Test-PSClassname<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-Client] <PSCustomObject><br>

samples/client/petstore/powershell/docs/PSPetApi.md

@@ -15,7 +15,7 @@ Method | HTTP request | Description
 [**Invoke-PSUploadFileWithRequiredFile**](PSPetApi.md#Invoke-PSUploadFileWithRequiredFile) | **POST** /fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)
 
 
-<a name="Add-PSPet"></a>
+<a id="Add-PSPet"></a>
 # **Add-PSPet**
 > void Add-PSPet<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-Pet] <PSCustomObject><br>
@@ -77,7 +77,7 @@ void (empty response body)
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="remove-pet"></a>
+<a id="remove-pet"></a>
 # **Remove-Pet**
 > void Remove-Pet<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-PetId] <Int64><br>
@@ -128,7 +128,7 @@ void (empty response body)
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Find-PSPetsByStatus"></a>
+<a id="Find-PSPetsByStatus"></a>
 # **Find-PSPetsByStatus**
 > Pet[] Find-PSPetsByStatus<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-Status] <String[]><br>
@@ -188,7 +188,7 @@ Name | Type | Description  | Notes
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Find-PSPetsByTags"></a>
+<a id="Find-PSPetsByTags"></a>
 # **Find-PSPetsByTags**
 > Pet[] Find-PSPetsByTags<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-Tags] <String[]><br>
@@ -248,7 +248,7 @@ Name | Type | Description  | Notes
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Get-PSPetById"></a>
+<a id="Get-PSPetById"></a>
 # **Get-PSPetById**
 > Pet Get-PSPetById<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-PetId] <Int64><br>
@@ -298,7 +298,7 @@ Name | Type | Description  | Notes
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Update-PSPet"></a>
+<a id="Update-PSPet"></a>
 # **Update-PSPet**
 > void Update-PSPet<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-Pet] <PSCustomObject><br>
@@ -360,7 +360,7 @@ void (empty response body)
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Update-PSPetWithForm"></a>
+<a id="Update-PSPetWithForm"></a>
 # **Update-PSPetWithForm**
 > void Update-PSPetWithForm<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-PetId] <Int64><br>
@@ -414,7 +414,7 @@ void (empty response body)
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Invoke-PSUploadFile"></a>
+<a id="Invoke-PSUploadFile"></a>
 # **Invoke-PSUploadFile**
 > ApiResponse Invoke-PSUploadFile<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-PetId] <Int64><br>
@@ -468,7 +468,7 @@ Name | Type | Description  | Notes
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-<a name="Invoke-PSUploadFileWithRequiredFile"></a>
+<a id="Invoke-PSUploadFileWithRequiredFile"></a>
 # **Invoke-PSUploadFileWithRequiredFile**
 > ApiResponse Invoke-PSUploadFileWithRequiredFile<br>
 > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[-PetId] <Int64><br>