Add a script to produce docs by language, and add multi-turn-conversation docs (#510)

* Add a script to produce docs by language, and add multi-turn-conversation docs.

* Fix typo.

* Remove java pivots, move source templates and update comments.

* Add links to docs from root readme

docs/generate-language-specific-docs.ps1

@@ -0,0 +1,70 @@
+$scriptDirectory = $PSScriptRoot
+$workspaceDirectory = Join-Path $scriptDirectory "../"
+$workspaceRoot = Resolve-Path "$workspaceDirectory"
+$userDocRoot = Join-Path $workspaceRoot "docs/docs-templates"
+$dotnetOutputRoot = Join-Path $workspaceRoot "user-documentation-dotnet"
+$pythonOutputRoot = Join-Path $workspaceRoot "user-documentation-python"
+
+Write-Host "Templates Root: " $userDocRoot
+Write-Host "Dotnet Output Root: " $dotnetOutputRoot
+Write-Host "Python Output Root: " $pythonOutputRoot
+
+# Delete all files in the ./user-documentation-dotnet directory.
+Get-ChildItem -Path $dotnetOutputRoot -Recurse | Remove-Item -Force -Recurse
+# Delete all files in the ./user-documentation-python directory.
+Get-ChildItem -Path $pythonOutputRoot -Recurse | Remove-Item -Force -Recurse
+
+# Copy all files from ./user-documentation to ./user-documentation-dotnet and ./user-documentation-python
+Get-ChildItem -Path $userDocRoot -Recurse | ForEach-Object {
+    if (-not $_.PSIsContainer) {
+        $relativePath = $_.FullName.Substring($userDocRoot.Length + 1)
+        $dotnetDestination = Join-Path $dotnetOutputRoot $relativePath
+        $pythonDestination = Join-Path $pythonOutputRoot $relativePath
+
+        # Create output folder if needed
+        $destinationDir = Split-Path $dotnetDestination -Parent
+        if (-not (Test-Path $destinationDir)) {
+            New-Item -ItemType Directory -Path $destinationDir -Force | Out-Null
+        }
+
+        $destinationDir = Split-Path $pythonDestination -Parent
+        if (-not (Test-Path $destinationDir)) {
+            New-Item -ItemType Directory -Path $destinationDir -Force | Out-Null
+        }
+
+        Write-Host "Copying $($_.FullName) to $dotnetDestination"
+        Write-Host "Copying $($_.FullName) to $pythonDestination"
+
+        # Copy the file
+        Copy-Item -Path $_.FullName -Destination $dotnetDestination -Force
+        Copy-Item -Path $_.FullName -Destination $pythonDestination -Force
+
+        # Read the contents of the copied file
+        $content = Get-Content -Path $dotnetDestination -Raw
+        # Remove the python sections
+        $pattern = '(?s)(::: zone pivot="programming-language-python"\s*).*?(::: zone-end)\r?\n'
+        $content = [regex]::Replace($content, $pattern, '')
+        # Remove the csharp markers
+        $pattern = '(?s)(::: zone pivot="programming-language-csharp"\s\r?\n*)'
+        $content = [regex]::Replace($content, $pattern, '')
+        # Remove the csharp markers
+        $pattern = '(?s)(::: zone-end)\r?\n'
+        $content = [regex]::Replace($content, $pattern, '')
+        # Write the modified contents back
+        Set-Content -Path $dotnetDestination -Value $content
+
+        # Read the contents of the copied file
+        $content = Get-Content -Path $pythonDestination -Raw
+        # Remove the csharp sections
+        $pattern = '(?s)(::: zone pivot="programming-language-csharp"\s*).*?(::: zone-end)\r?\n'
+        $content = [regex]::Replace($content, $pattern, '')
+        # Remove the csharp markers
+        $pattern = '(?s)(::: zone pivot="programming-language-python"\s\r?\n*)'
+        $content = [regex]::Replace($content, $pattern, '')
+        # Remove the python markers
+        $pattern = '(?s)(::: zone-end)\r?\n'
+        $content = [regex]::Replace($content, $pattern, '')
+        # Write the modified contents back
+        Set-Content -Path $pythonDestination -Value $content
+    }
+}