deprecate service packages and HLLs

Author: lucix-aws

private/model/api/codegentest/service/awsendpointdiscoverytest/doc.go

@@ -206,6 +206,15 @@ func Must(err error) {
 	}
 }
 
+const docLayout = `// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
+
+%s
+//
+// Deprecated: aws-sdk-go is deprecated. Use aws-sdk-go-v2.
+// See https://aws.amazon.com/blogs/developer/announcing-end-of-support-for-aws-sdk-for-go-v1-on-july-31-2025/.
+package %s
+`
+
 const codeLayout = `// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
 
 %s
@@ -221,10 +230,9 @@ func writeGoFile(file string, layout string, args ...interface{}) error {
 // writeServiceDocFile generates the documentation for service package.
 func writeServiceDocFile(g *generateInfo) error {
 	return writeGoFile(filepath.Join(g.PackageDir, "doc.go"),
-		codeLayout,
+		docLayout,
 		strings.TrimSpace(g.API.ServicePackageDoc()),
 		g.API.PackageName(),
-		"",
 	)
 }