Sync eng/common directory with azure-sdk-tools for PR 4480 (#26992)

* Add extra parameters for .net readme path

* Use another way for default value

* Remove custom source

Co-authored-by: sima-zhu <[email protected]>

Author: azure-sdk

eng/common/scripts/Update-DocsMsToc.ps1

@@ -29,14 +29,19 @@ depending on the requirements for the domain
 .PARAMETER OutputLocation
 Output location for unified reference yml file
 
+.PARAMETER ReadmeFolderRoot
+The readme folder root path, use default value here for backward compability. E.g. docs-ref-services in Java, JS, Python, api/overview/azure
 #>
 
 param(
   [Parameter(Mandatory = $true)]
   [string] $DocRepoLocation,
 
   [Parameter(Mandatory = $true)]
-  [string] $OutputLocation
+  [string] $OutputLocation,
+
+  [Parameter(Mandatory = $false)]
+  [string] $ReadmeFolderRoot = 'docs-ref-services'
 )
 . $PSScriptRoot/common.ps1
 . $PSScriptRoot/Helpers/PSModule-Helpers.ps1
@@ -208,7 +213,7 @@ foreach ($service in $serviceNameList) {
   $serviceReadmeBaseName = $service.ToLower().Replace(' ', '-').Replace('/', '-')
   $serviceTocEntry = [PSCustomObject]@{
     name            = $service;
-    href            = "~/docs-ref-services/{moniker}/$serviceReadmeBaseName.md"
+    href            = "~/$ReadmeFolderRoot/{moniker}/$serviceReadmeBaseName.md"
     landingPageType = 'Service'
     items           = @($packageItems)
   }