Problemas conhecidos informam os usuários sobre problemas identificados na plataforma ou nos produtos da VTEX, seu status atual e possíveis soluções provisórias (workarounds) ou correções permanentes. Atualizamos constantemente esses artigos para que você possa antecipar possíveis problemas e saber que nossa equipe está atenta a eles.
Neste artigo, apresentamos uma visão geral sobre a estrutura dos problemas conhecidos, diferenciando-os de outros tipos de conteúdo e de melhorias de produto.
Diferenças entre problemas conhecidos e e outros artigos
Ao navegar pela documentação da VTEX, é importante entender as diferenças entre os tipos de artigo e suas finalidades específicas. Por exemplo, os artigos sobre problemas conhecidos alertam os usuários sobre problemas identificados na plataforma, indicando atualizações, soluções provisórias ou definitivas. Por outro lado, os guias de solução de problemas oferecem instruções detalhadas para corrigir erros específicos.
A tabela abaixo compara os artigos de problemas conhecidos com outros tipos de artigo:
| Tema | Problema conhecido | Solução de problemas |
|---|---|---|
| Objetivo | Informar os usuários sobre problemas conhecidos na plataforma e nos produtos, bem como suas soluções provisórias (workarounds) ou definitivas. | Oferecer instruções detalhadas para resolver problemas ou erros específicos. |
| Foco do conteúdo | Descrição do problema, impacto, solução provisória (workaround) ou definitiva e atualizações de status. | Etapas de resolução de problemas, mensagens de erro e possíveis causas. |
| Público-alvo | Todos os usuários que possam ser afetados pelo problema conhecido. | Usuários com problemas ou erros específicos. |
| Exemplo | Promoções e impostos não são aplicados a serviços | O Site Editor da minha loja não está funcionando |
Diretrizes para identificar problemas conhecidos ou melhorias no produto
Tanto os problemas conhecidos quanto as melhorias do produto têm como objetivo aprimorar o produto. No entanto, enquanto os artigos de problemas conhecidos focam em resolver problemas existentes, as melhorias do produto visam adicionar novas funcionalidades ou aprimorar as já existentes.
Para ilustrar melhor a diferença entre eles, veja a tabela abaixo:
| Tema | Problema conhecido | Melhoria de produto |
|---|---|---|
| Definição | Um problema ou bug identificado no produto ou na plataforma. | Uma alteração projetada para aprimorar o produto ou questões de funcionalidade, usabilidade ou desempenho da plataforma. |
| Foco | Corrigir problemas existentes. | Adicionar novas funcionalidades ou melhorar as existentes. |
| Impacto para o usuário | Impacto negativo na experiência do usuário ou na funcionalidade. | Impacto positivo na experiência do usuário ou na funcionalidade. |
| Exemplo | Um botão em uma página não funciona como esperado. | Adicionar uma nova funcionalidade para filtrar os resultados de busca. |
Estrutura de problemas conhecidos
| Tema do artigo | Descrição |
|---|---|
| 1 - Título | Título do artigo que descreve o problema. |
| 2 - Nome do produto | Tag para o produto afetado pelo problema. |
| 3 - Zendesk ID | Identificador único do problema conhecido no Zendesk. |
| 4 - Status | Tag que descreve o status do problema conhecido. Estes são os status disponíveis:
|
| 5 - Publicado em | Data em que o artigo foi criado. |
| 6 - Última atualização em | Data da última atualização do artigo. |
| 7 - Sumário | Seção para descrever o bug. |
| 8 - Simulação | Seção para descrever quais etapas são necessárias para reproduzir o comportamento. |
| 9 - Workaround | Seção para descrever o workaround para o problema, caso exista. |
Exemplos de problemas conhecidos
- O carrinho não é atualizado no FastStore se for feita uma solicitação externa para atualizar o formulário de pedido
- Transações bloqueadas após a rejeição do risco
- Promoções e impostos não são aplicados a serviços
- FetchMore traz valores repetidos entre o to e o from