Tools: Writeme canonical titles (#6382)

* Fix some WRITEME issues and generate titles for Actions:
* Open files with utf-8 encoding.
* Case-insensitive README filename comparison.
* Render titles for actions in READMEs.
* Fixed WRITEME to check for combined language and version.
* Remove case-insensitive README lookup, rename wrong case Readme.md to README.md.

Author: Laren-AWS

Diff for: .doc_gen/metadata/application-auto-scaling_metadata.yaml

@@ -14,7 +14,7 @@ application-autoscaling_RegisterScalableTarget:
               snippet_tags:
                 - appautoscale.java2.enable.main
   services:
-    application-autoscaling: {RegisterScalableTarget}
+    application-auto-scaling: {RegisterScalableTarget}
 application-autoscaling_DeleteScalingPolicy:
   title: Disable a resource that is scaled using an &APP-ASlong; SDK
   title_abbrev: Disables a  resource
@@ -30,7 +30,7 @@ application-autoscaling_DeleteScalingPolicy:
               snippet_tags:
                 - appautoscale.java2.disable.main
   services:
-    application-autoscaling: {DeleteScalingPolicy}   
+    application-auto-scaling: {DeleteScalingPolicy}
 application-autoscaling_DescribeScalingPolicies:
   title: Describe &APP-AS; scaling policies using an &AWS; SDK
   title_abbrev: Describes scaling policies
@@ -47,5 +47,5 @@ application-autoscaling_DescribeScalingPolicies:
               snippet_tags:
                 - applicationautoscaling.rust.describe-scaling-policies
   services:
-    application-autoscaling: {DescribeScalingPolicies}
+    application-auto-scaling: {DescribeScalingPolicies}
 

Diff for: .doc_gen/metadata/services.yaml

@@ -103,21 +103,6 @@ apigatewayv2:
   tags:
     product_categories: {'Networking & Content Delivery'}
   version: '2018-11-29'
-application-autoscaling:
-  long: '&APP-ASlong;'
-  short: '&APP-AS;'
-  sort: Application Auto Scaling
-  expanded:
-    long: AWS Application Auto Scaling
-    short: Application Auto Scaling
-  blurb: configures auto scaling for resources beyond just EC2, either with scaling policies or with scheduled scaling.
-  guide:
-    subtitle: User Guide
-    url: autoscaling/application/userguide/what-is-application-auto-scaling.html
-  api_ref: autoscaling/application/APIReference/Welcome.html
-  tags:
-    product_categories: {'Management & Governance'}
-  version: application-autoscaling-2016-02-06
 app-mesh:
   api_ref: app-mesh/latest/APIReference/Welcome.html
   blurb: ''
@@ -150,7 +135,7 @@ appconfig:
   version: '2019-10-09'
 application-auto-scaling:
   api_ref: autoscaling/application/APIReference/Welcome.html
-  blurb: ''
+  blurb: configures auto scaling for resources beyond just EC2, either with scaling policies or with scheduled scaling.
   expanded:
     long: Application Auto Scaling
     short: Application Auto Scaling
@@ -161,8 +146,8 @@ application-auto-scaling:
   short: '&APP-AS;'
   sort: Application Auto Scaling
   tags:
-    product_categories: {}
-  version: '2016-02-06'
+    product_categories: {'Management & Governance'}
+  version: application-autoscaling-2016-02-06
 application-discovery-service:
   api_ref: application-discovery/latest/APIReference/Welcome.html
   blurb: ''
@@ -486,7 +471,7 @@ cloudsearch-domain:
   version: '2013-01-01'
 cloudtrail:
   api_ref: awscloudtrail/latest/APIReference/Welcome.html
-  blurb: ''
+  blurb: helps you monitor your AWS deployments in the cloud by getting a history of AWS API calls for your account.
   expanded:
     long: AWS CloudTrail
     short: CloudTrail
@@ -3055,22 +3040,6 @@ transcribe:
   tags:
     product_categories: {'Machine Learning & AI'}
   version: transcribe-2017-10-26
-transcribe-medical:
-  long: '&TSCMlong;'
-  short: '&TSCM;'
-  sort: Transcribe Medical
-  expanded:
-    long: Amazon Transcribe Medical
-    short: Amazon Transcribe Medical
-  blurb: is an automatic speech recognition (ASR) service designed for medical professionals who want to transcribe
-    medical-related speech, such as physician-dictated notes, drug safety monitoring, telemedicine appointments, or physician-patient conversations.
-  guide:
-    subtitle: Developer Guide
-    url: transcribe/latest/dg/transcribe-medical.html
-  api_ref: transcribe/latest/APIReference/Welcome.html
-  tags:
-    product_categories: {'Machine Learning & AI'}
-  version: transcribe-2017-10-26
 translate:
   long: '&TSLlong;'
   short: '&TSL;'

Diff for: .doc_gen/metadata/transcribe-medical_metadata.yaml

@@ -374,3 +374,90 @@ transcribe_Scenario_CustomVocabulary:
   services:
     transcribe: {StartTranscriptionJob, GetTranscriptionJob, DeleteTranscriptionJob, CreateVocabulary,
                  GetVocabulary, UpdateVocabulary, ListVocabularies, DeleteVocabulary}
+transcribe_StartMedicalTranscriptionJob:
+  title: Start an &TSCM; transcription job using an &AWS; SDK
+  title_abbrev: Start a medical transcription job
+  synopsis: start an &TSCM; transcription job.
+  category:
+  languages:
+    .NET:
+      versions:
+        - sdk_version: 3
+          github: dotnetv3/Transcribe
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - Transcribe.dotnetv3.StartMedicalTranscriptionJob
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/transcribe
+          sdkguide: sdk-for-javascript/v3/developer-guide/transcribe-medical-examples-section.html#transcribe-start-medical-transcription
+          excerpts:
+            - description: Create the client.
+              snippet_tags:
+                - transcribe.JavaScript.createclientv3
+            - description: Start a medical transcription job.
+              snippet_tags:
+                - transcribe.JavaScript.jobs.createMedicalJobV3
+  services:
+    transcribe: {StartMedicalTranscriptionJob}
+transcribe_DeleteMedicalTranscriptionJob:
+  title: Delete a &TSCM; transcription job using an &AWS; SDK
+  title_abbrev: Delete a medical transcription job
+  synopsis: delete an &TSCM; transcription job.
+  category:
+  languages:
+    .NET:
+      versions:
+        - sdk_version: 3
+          github: dotnetv3/Transcribe
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - Transcribe.dotnetv3.DeleteMedicalTranscriptionJob
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/transcribe
+          sdkguide: sdk-for-javascript/v3/developer-guide/transcribe-medical-examples-section.html#transcribe-delete-medical-job
+          excerpts:
+            - description: Create the client.
+              snippet_tags:
+                - transcribe.JavaScript.createclientv3
+            - description: Delete a medical transcription job.
+              snippet_tags:
+                - transcribe.JavaScript.jobs.deleteMedicalJobV3
+  services:
+    transcribe: {DeleteMedicalTranscriptionJob}
+transcribe_ListMedicalTranscriptionJobs:
+  title: List &TSCM; transcription jobs using an &AWS; SDK
+  title_abbrev: List medical transcription jobs
+  synopsis: list &TSCM; transcription jobs.
+  category:
+  languages:
+    .NET:
+      versions:
+        - sdk_version: 3
+          github: dotnetv3/Transcribe
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - Transcribe.dotnetv3.ListMedicalTranscriptionJobs
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/transcribe
+          sdkguide: sdk-for-javascript/v3/developer-guide/transcribe-medical-examples-section.html#transcribe-list-medical-jobs
+          excerpts:
+            - description: Create the client.
+              snippet_tags:
+                - transcribe.JavaScript.createclientv3
+            - description: List medical transcription jobs.
+              snippet_tags:
+                - transcribe.JavaScript.jobs.createMedicalJobV3
+  services:
+    transcribe: {ListMedicalTranscriptionJobs}

Diff for: .doc_gen/metadata/transcribe_metadata.yaml

@@ -21,6 +21,7 @@
     "&IAM-users;": "IAM users",
     "&kms-key;": "KMS key",
     "&kms-keys;": "KMS keys",
+    "&S3long;": "Amazon Simple Storage Service",
     "&SLN;": "Amazon States Language",
 }
 language = {
@@ -44,7 +45,6 @@
             "service_folder": 'javav2/example_code/{{service["name"]}}',
             "sdk_api_ref": 'https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/{{service["name"]}}/package-summary.html',
             "service_folder_overrides": {
-                "sesv2": "javav2/example_code/ses",
                 "medical-imaging": "javav2/example_code/medicalimaging",
             },
         },

Diff for: .tools/readmes/config.py

@@ -8,7 +8,7 @@
 import os
 import sys
 from pathlib import Path
-from render import Renderer
+from render import Renderer, MissingMetadataError
 from scanner import Scanner
 
 
@@ -82,7 +82,7 @@ def main():
             for service in args.services:
                 id = f"{language}:{version}:{service}"
                 try:
-                    scanner.set_example(language, service)
+                    scanner.set_example(language, int(version), service)
                     logging.debug("Rendering %s", id)
                     renderer = Renderer(scanner, int(version), args.safe)
 
@@ -99,6 +99,9 @@ def main():
                         written.append(id)
                 except FileNotFoundError:
                     skipped.append(id)
+                except MissingMetadataError as mme:
+                    logging.error(mme)
+                    failed.append(id)
                 except Exception:
                     logging.exception("Exception rendering %s", id)
                     failed.append(id)

Diff for: .tools/readmes/multi.py

@@ -111,9 +111,9 @@ def _transform_service(self):
             post_svc["guide"]["url"] = self._doc_link(post_svc["guide"]["url"])
         return post_svc
 
-    def _transform_actions(self, pre_actions):
-        post_actions = []
-        for _, pre in pre_actions.items():
+    def _transform_hello(self, pre_hello):
+        post_hello = []
+        for _, pre in pre_hello.items():
             try:
                 api = next(iter(pre["services"][self.scanner.svc_name]))
             except:
@@ -126,6 +126,23 @@ def _transform_actions(self, pre_actions):
                 ),
                 "api": api,
             }
+            post_hello.append(action)
+        return sorted(post_hello, key=itemgetter("title_abbrev"))
+
+
+    def _transform_actions(self, pre_actions):
+        post_actions = []
+        for pre_id, pre in pre_actions.items():
+            try:
+                api = next(iter(pre["services"][self.scanner.svc_name]))
+            except:
+                raise MissingMetadataError(f"Action not found for example {pre_id} and service {self.scanner.svc_name}.")
+            action = {
+                "title_abbrev": api,
+                "file": self.scanner.snippet(
+                    pre, self.sdk_ver, self.lang_config["service_folder"], api
+                ),
+            }
             post_actions.append(action)
         return sorted(post_actions, key=itemgetter("title_abbrev"))
 
@@ -273,7 +290,7 @@ def render(self):
             return None
         sdk = self._transform_sdk()
         svc = self._transform_service()
-        hello = self._transform_actions(self.scanner.hello())
+        hello = self._transform_hello(self.scanner.hello())
         actions = self._transform_actions(self.scanner.actions())
         scenarios = self._transform_scenarios()
         custom_cats = self._transform_custom_categories()
@@ -314,6 +331,7 @@ def write(self):
                 self.readme_filename,
                 f'{self.lang_config["service_folder"]}/{config.saved_readme}',
             )
+        os.remove(self.readme_filename) #  Do this so that new files are always updated to the correct case (README.md).
         with open(self.readme_filename, "w", encoding="utf-8") as f:
             f.write(self.readme_text)
         print(f"Updated {self.readme_filename}.")