Pular para o conteúdo principal

Registo de Alterações da Documentação - PDF Connect v3

2026-02-21 Atualização: Blocos de URL Manual​

  • Adicionado novo guia: manual-url-blocks.md
  • Atualizada a documentação de publicação/configuração/visualizador/apresentação para incluir os blocos manuais em templates de produto
  • Adicionadas clarificações sobre o comportamento “ligado” vs. “manual”
  • Adicionadas verificações de resolução de problemas específicas do modo manual
  • Atualizada a navegação da barra lateral para incluir o novo guia

Visão geral​

Este registo acompanha a renovação completa da documentação do PDF Connect v3, que introduziu ligação universal a páginas, fluxos de publicação melhorados e uma experiência/UI mais consistente.

Legenda de estado​

  • ✅ Concluído - Ficheiro atualizado com funcionalidades v3 e pronto para novas capturas de ecrã
  • 🔄 Em progresso - Ficheiro a ser atualizado
  • ❌ Precisa de atualização - Ficheiro antigo que precisa de renovação para v3
  • 📸 Precisa de capturas de ecrã - Conteúdo atualizado e pronto para novas imagens

Ficheiros atualizados (v3)​

Guias principais - CONCLUÍDO ✅​

intro-v3.md ✅​

  • Estado: Concluído, precisa de capturas de ecrã
  • Alterações:
    • Atualizado para descrever três estilos de apresentação (PDF Incorporado, Botão de PDF, Lista de PDFs)
    • Adicionadas capacidades de ligação universal (todos os tipos de página)
    • Enfatizado o fluxo de publicação simplificado em dois passos
    • Adicionados casos de sucesso e propostas de valor para o negócio
  • Ficheiro antigo: intro.md → intro-old.md
  • Capturas de ecrã necessárias: 8 capturas-chave identificadas em SCREENSHOT_REQUIREMENTS.md

tutorial-basics/link-pdfs-v3.md ✅​

  • Estado: Concluído, precisa de capturas de ecrã
  • Alterações:
    • Reescrita completa para ligação universal (todos os tipos de página)
    • Melhorias em pesquisa, paginação e seleção em massa
    • Adicionadas estratégias de ligação entre páginas e secções de resolução de problemas
    • Colocação estratégica de marcadores de “captura de ecrã necessária”
  • Ficheiro antigo: tutorial-basics/link-pdfs.md → tutorial-basics/link-pdfs-old.md
  • Capturas de ecrã necessárias: 12 capturas-chave identificadas

tutorial-basics/place-linked-pdf-v3.md ✅​

  • Estado: Concluído, precisa de capturas de ecrã
  • Alterações:
    • Atualizado para refletir o novo sistema de modais de publicação
    • Adicionados três estilos de apresentação distintos, com casos de uso detalhados
    • Melhorias na seleção de templates e em estratégias com múltiplos blocos
    • Secções de otimização de desempenho e resolução de problemas
  • Ficheiro antigo: tutorial-basics/place-linked-pdf.md → tutorial-basics/place-linked-pdf-old.md
  • Capturas de ecrã necessárias: 15 capturas-chave identificadas

publishing-workflow-v3.md ✅​

  • Estado: Ficheiro novo, concluído, precisa de capturas de ecrã
  • Objetivo: Guia completo do fluxo de trabalho do novo sistema de publicação
  • Conteúdo:
    • Boas práticas e resolução de problemas, em detalhe
    • Estratégias de gestão de templates
    • Otimização de desempenho e UX
  • Capturas de ecrã necessárias: 8 capturas específicas do fluxo de trabalho identificadas

Ficheiros que precisam de atualização ❌​

Tutoriais básicos​

  • tutorial-basics/upload-a-pdf.md ❌ - Precisa de atualizações de UI v3
  • tutorial-basics/account-and-subscription.md ❌ - Provavelmente inalterado
  • tutorial-basics/paste-pdf-id.md ❌ - Pode ser uma funcionalidade legada
  • tutorial-basics/place-non-prd-page.md ❌ - Substituído pela ligação universal
  • tutorial-basics/place-linked-pdf-legacy.md ❌ - Método legado, pode ser arquivado

Tutoriais extra​

  • tutorial-extras/link-pdfs-bulk.md ❌ - Precisa de atualizações na UI de operações em massa (v3)
  • tutorial-extras/external-pdfs.md ❌ - Precisa de atualizações da interface v3
  • tutorial-extras/pdf-viewers.md ❌ - Precisa das opções de visualizador v3
  • tutorial-extras/using-tags.md ❌ - Precisa da interface de etiquetas v3
  • tutorial-extras/translate-your-site.md ❌ - Provavelmente inalterado

Secção legada​

  • legacy/button-designer.md ❌ - Substituído por blocos no editor de temas
  • legacy/pdf-placement.md ❌ - Substituído pelo fluxo de publicação

Requisitos de capturas de ecrã​

Prioridade 1 - Fluxo principal 📸​

  1. Visão geral da app: Interface principal de gestão de PDFs
  2. Interface de ligação: Novo seletor de tipo de página e seleção
  3. Modal de publicação: Três opções de estilo de apresentação
  4. Editor de temas: Adicionar blocos de PDF aos templates
  5. Seleção de recursos: Pesquisa e paginação em funcionamento

Prioridade 2 - Funcionalidades avançadas 📸​

  1. Templates com vários blocos: Exemplos de estilos diferentes na mesma página
  2. Operações em massa: Interface de importação via folha de cálculo
  3. Definições e personalização: Opções de configuração dos blocos
  4. Vistas em mobile: Como os PDFs aparecem em dispositivos móveis
  5. Ferramentas de desempenho: Funcionalidades de analítica e otimização

Prioridade 3 - Casos de uso 📸​

  1. Exemplo de manual de produto: PDF incorporado na página de produto
  2. Catálogo de coleção: Lista de PDFs na página de coleção
  3. Recurso no blog: Botão de PDF na página de artigo
  4. Funcionalidade na homepage: Integração de PDF na página inicial
  5. Estados de erro: O que os utilizadores veem quando algo corre mal

Notas para a sessão de capturas​

Elementos de interface a capturar:​

  • Novos menus suspensos e interfaces de seleção
  • Modais melhorados, com UX aprimorada
  • Pontos de integração com o editor de temas
  • Vistas responsivas em mobile
  • Estados de erro e de carregamento

Exemplos de conteúdo a preparar:​

  • PDFs de exemplo com nomes/descrições realistas
  • Produtos, coleções, artigos e páginas de teste
  • Vários tamanhos e tipos de PDF
  • Preparação do teste em dispositivos móveis

Comparações antes/depois:​

  • Interface de ligação antiga vs. nova
  • Colocação legada vs. blocos no editor de temas
  • Só produtos vs. ligação universal
  • Estilo único de apresentação vs. múltiplas opções

Estratégia de migração​

Fase 1: Documentação principal ✅​

  • Atualizar os guias principais do fluxo de trabalho
  • Criar documentação abrangente das funcionalidades
  • Estabelecer uma nova convenção de nomes de ficheiros

Fase 2: Guias detalhados 🔄​

  • Atualizar os guias de upload e de conta
  • Renovar a documentação de operações em massa
  • Atualizar os guias de PDFs externos e de visualizadores

Fase 3: Gestão de legado 📋​

  • Arquivar funcionalidades substituídas
  • Criar guias de migração para utilizadores existentes
  • Atualizar navegação e referências cruzadas

Fase 4: Melhoria visual 📸​

  • Coordenar sessão de capturas de ecrã
  • Substituir todas as imagens placeholder
  • Adicionar tutoriais em vídeo para fluxos complexos
  • Testar a documentação com comerciantes reais

Sistema de renovação da documentação implementado ✅​

Estratégia de gestão de ficheiros​

  • Convenção de nomes: Todos os ficheiros novos usam o sufixo -v3 para identificação fácil
  • Preservação de ficheiros antigos: Ficheiros originais renomeados com o sufixo -old para referência
  • Rastreio de alterações: Registo completo com estados e requisitos de capturas de ecrã

Estratégia de gestão de imagens​

  • Imagens antigas removidas: Todas as capturas desatualizadas removidas da documentação
  • Placeholders estratégicos: [SCREENSHOT NEEDED: Description] colocado onde as imagens acrescentam valor
  • Documentação de requisitos: Requisitos completos de capturas num ficheiro dedicado
  • Sistema de prioridades: Sistema de três níveis para captação de capturas de ecrã

Processo de garantia de qualidade​

  • Revisão de conteúdo: Todos os ficheiros v3 revistos quanto a exatidão e completude
  • Validação de links: Links internos atualizados para apontar para versões v3
  • Verificação de consistência: Formatação e terminologia uniformes em todos os ficheiros
  • Acessibilidade: Planeamento de requisitos de texto alternativo e placeholders descritivos

Ficheiros renovados com sucesso​

Documentação principal ✅​

  1. intro-v3.md - Introdução principal com funcionalidades v3
  2. tutorial-basics/link-pdfs-v3.md - Guia de ligação universal
  3. tutorial-basics/place-linked-pdf-v3.md - Guia de publicação melhorado
  4. publishing-workflow-v3.md - Guia completo do fluxo de trabalho

Documentação de suporte ✅​

  1. DOCUMENTATION_CHANGELOG.md - Rastreio de alterações e estados
  2. SCREENSHOT_REQUIREMENTS.md - Planeamento de conteúdos visuais

Próximos ficheiros (planeados)​

  • getting-started-v3.md - Guia moderno de onboarding
  • advanced-features-v3.md - Funcionalidades para utilizadores avançados
  • tutorial-basics/upload-a-pdf-v3.md - Processo de upload atualizado
  • tutorial-extras/link-pdfs-bulk-v3.md - Operações em massa melhoradas

Esta abordagem sistemática garante:

  • Zero perda de conteúdo: Todo o conteúdo original é preservado
  • Clear Progress Tracking: Easy to see what's done vs. what needs work
  • Professional Quality: Consistent, modern documentation standards
  • Future-Ready: Scalable system for ongoing updates

Success Metrics​

Documentation Quality:​

  • All v3 features documented comprehensively
  • Clear migration path from v2 to v3
  • Reduced support tickets about new features
  • Positive merchant feedback on clarity

Visual Enhancement:​

  • Modern screenshots reflecting current UI
  • Consistent visual language across all guides
  • Mobile-optimized documentation experience
  • Video supplements for complex workflows

This renovation will ensure our documentation matches the quality and sophistication of the new PDF Connect v3 features.