Merge branch 'main' into diego/acs-2131-add-documentation-of-android-seam-components-to-docsseamco

Author: dawnho

codegen/layouts/api-endpoint.hbs

@@ -9,6 +9,10 @@
 - [Examples](#examples)
 {{/if}}
 
+{{#if this.isDeprecated}}
+{{> deprecated-warning}}
+
+{{/if}}
 {{{description}}}
 
 {{#with primaryCodeSample}}
@@ -73,7 +77,11 @@ None
 
 ## Response
 
-{{#if response.resourceType}}{{#if (eq response.responseType "resource_list")}}Array of [{{response.escapedResourceType}}s]({{#if response.responsePath}}{{response.responsePath}}{{else}}./{{/if}}){{else}}[{{response.escapedResourceType}}]({{#if response.responsePath}}{{response.responsePath}}{{else}}./{{/if}}){{/if}}{{else}}void{{/if}}
+{% hint style="success" %}
+Returns:
+**{{#if response.resourceType}}{{#if (eq response.responseType "resource_list")}}Array of [{{response.escapedResourceType}}s]({{#if response.responsePath}}{{response.responsePath}}{{else}}./{{/if}}){{else}}[{{response.escapedResourceType}}]({{#if response.responsePath}}{{response.responsePath}}{{else}}./{{/if}}){{/if}}{{else}}void{{/if}}**
+
+{% endhint %}
 
 {{#if resourceSamples.length}}
 

codegen/lib/layout/api-endpoint.ts

@@ -40,6 +40,8 @@ export interface ApiEndpointLayoutContext {
   workspaceScope: SeamWorkspaceScope
   isAlpha: boolean
   alphaMessage: string | undefined
+  isDeprecated: boolean
+  deprecationMessage: string
   request: {
     preferredMethod: string
     parameters: ApiEndpointParameter[]
@@ -124,6 +126,8 @@ export function setEndpointLayoutContext(
   file.workspaceScope = endpoint.workspaceScope
   file.isAlpha = (metadata.alpha ?? '').length > 0
   file.alphaMessage = metadata.alpha
+  file.isDeprecated = endpoint.isDeprecated
+  file.deprecationMessage = endpoint.deprecationMessage
 
   file.authMethods = endpoint.authMethods
     .filter(