Change overview generation script

Author: jairmyree

eng/pipelines/scripts/generate_overview_from_readme.py

@@ -46,12 +46,13 @@ def generate_overview(readme_file, version, overview_file_path):
 
         # Before passing the README contents to markdown2 clean out the codesnippet tags on the java code fences.
         # Clean ```java com.azure.core.aCodeSnippetTag to ```java, without doing this markdown2 won't properly process
-        # the contents of the code fence.
+        # the contents of the code fence. Replace '&' with '&' to avoid issues with the HTML parser.
         cleaned_readme_content_lines = []
         for line in raw_readme_content_lines:
             cleaned_readme_content_lines.append(re.sub(pattern="``` *java +[a-zA-Z0-9.#\-_]*", repl="```java", string=line, flags=re.UNICODE))
 
         readme_content = ''.join(cleaned_readme_content_lines)
+        readme_content = re.sub(pattern='\\B&\\B', repl='&', string=readme_content, flags=re.UNICODE)
 
         # markdown2.markdown will create html from the readme.md file. The fenced-code-blocks
         # extras being passed into the markdown call is necessary to deal with the embedded

eng/pipelines/templates/stages/archetype-sdk-client-patch.yml

@@ -124,7 +124,7 @@ extends:
               inputs:
                 mavenPomFile: ClientFromSourcePom.xml
                 goals: 'deploy'
-                options: '$(DefaultOptions) -T ${{parameters.BuildParallelization}} -DskipTests -Dgenerate-overview -DXdoclint:none -Dconfiguration=-Xdoclint:none -Dspotbugs.skip=true -Dcheckstyle.skip=true -Drevapi.skip=true -Dspotless.apply.skip=true -pl $(ProjectList) -am -DaltDeploymentRepository=id::default::file://$(System.DefaultWorkingDirectory)/build' # We include template-module, so we ensure it always builds in CI.
+                options: '$(DefaultOptions) -T ${{parameters.BuildParallelization}} -DskipTests -Dgenerate-overview -Dspotbugs.skip=true -Dcheckstyle.skip=true -Drevapi.skip=true -Dspotless.apply.skip=true -pl $(ProjectList) -am -DaltDeploymentRepository=id::default::file://$(System.DefaultWorkingDirectory)/build' # We include template-module, so we ensure it always builds in CI.
                 mavenOptions: '$(MemoryOptions) $(LoggingOptions)'
                 javaHomeOption: 'JDKVersion'
                 jdkVersionOption: ${{ parameters.JavaBuildVersion }}