Referência do documento de blueprint

Use esta habilidade ao criar ou editar documentos de blueprint neste repositório. Os blueprints são implementações repetíveis que abordam problemas comerciais estabelecidos e incluem diagramas de arquitetura, considerações técnicas e links para a documentação relacionada da Adobe Experience League.

Quando aplicar

• Criar um novo documento de blueprint ou página de visão geral do blueprint
• Adicionar ou reestruturar seções em um blueprint existente
• Vincular ou citar a documentação da Adobe Experience League
• Alinhamento do novo conteúdo com as convenções do blueprint (frente, cabeçalhos, diagramas)

Referência rápida

1. Finalidade do documento: os blueprints fornecem arquitetura de fluxo de dados e sistema para mostrar como a Adobe Experience Platform e os aplicativos são integrados. Elas são visuais e técnicas, não de marketing.
2. Seções: usar as seções padrão do modelo; omitir somente quando não aplicável (consulte reference.md).
3. Experience League: prefira vincular ao Experience League para documentos de produto, APIs, medidas de proteção e tutoriais. Use URLs completos. Consulte reference.md para obter padrões e formatação de URL.
4. Estrutura do repositório: os blueprints ficam em help/blueprints/. Atualizar help/blueprints/TOC.md ao adicionar ou mover páginas de blueprint.

Modelo de documento

Cada página do blueprint deve seguir essa estrutura. Inclua somente as seções que se aplicam.

markdown
1---
2title: [Short descriptive title]
3description: "[One sentence: what this blueprint shows and why it matters.]"
4solution: [Product name, e.g. Real-Time Customer Data Platform, Journey Optimizer]
5exl-id: [UUID - if this is already popultated keep it as is. Disregard and remove this field if it is a new blueprint as blank values will be rejected by the publishing flow. If the field and value are not present, it will be auto-generated as part of the Experience League publishing flow]
6---
7# [H1 - same as title or expanded]
8
9[1–3 paragraphs: what the blueprint covers, key capabilities, and who it’s for.]
10
11## Applications
12
13* [Product 1]
14* [Product 2]
15
16## Use cases
17
18* [Use case 1]
19* [Use case 2]
20
21## Prerequisites
22
23[Bullets or short paragraphs: required products, config, or setup.]
24
25## Architecture Diagram
26
27<img src="[path to SVG/image]" alt="[Descriptive alt]" style="width:90%; border:1px solid #4a4a4a" class="modal-image" />
28
29## Guardrails
30
31[Link to Experience League guardrails and any blueprint-specific limits.]
32
33## Implementation patterns
34
35[Optional: named patterns with bullets.]
36
37## Implementation steps
38
391. [Step with link to Experience League where relevant]
402. ...
41
42## Implementation considerations
43
44[Optional: identity, performance, security, etc.]
45
46## Related documentation
47
48[Grouped links to Experience League: product docs, APIs, tutorials.]

Para obter uma visão geral ou páginas de hub, use uma estrutura mais curta: introdução, casos de uso (ou guias), imagem da arquitetura, tabela de cenários/padrões, pré-requisitos, medidas de proteção e documentação relacionada. Veja as visões gerais existentes em help/blueprints/ para ver exemplos.

Frontmatter

Referência à Adobe Experience League

• Quando vincular: vincular à Experience League para obter a documentação do produto, referências de API, medidas de proteção, tutoriais e etapas de configuração. Não duplique procedimentos longos; resuma e vincule.
• Formato de URL: usar URLs completas. Prefira https://experienceleague.adobe.com/docs/?lang=pt-BR... ou https://experienceleague.adobe.com/pt-br/docs/.... Para documentos do desenvolvedor, https://developer.adobe.com/... também é válido.
• Texto do link: use texto descritivo (por exemplo, "[Criar esquemas] (url)" e não "Clique aqui"). Para nomes de produtos no texto do link, use [!DNL Product Name] quando apropriado.
• Seção de documentação relacionada: encerre blueprints com uma seção de "Documentação relacionada" agrupando links por categoria (por exemplo, configurações de destino, documentação do SDK, Perfil e segmentação, Tutoriais).

Para obter padrões detalhados de URL, agrupamento de links e exemplos, consulte reference.md.

Lista de verificação antes de enviar

• O Frontmatter tem title, description, solution, exl-id
• H1 corresponde ou expande apropriadamente o título
• [ Diagrama de arquitetura ] presente e texto alternativo descritivo
• Link das etapas de implementação para a Experience League onde os procedimentos estão
• [ A seção ] Medidas de proteção está vinculada aos documentos oficiais da Experience League
• A seção de documentação relacionada inclui links relevantes do Experience League
• páginas novas ou movidas são refletidas em help/blueprints/TOC.md

Recursos adicionais

• Modelo completo e notas de seção: reference.md
• Blueprints existentes: help/blueprints/ (por exemplo, audience-activation/real-time-lookup.md, customer-journeys/journey-optimizer/journey-optimizer-overview.md)
• Sumário e navegação: help/blueprints/TOC.md