Guia de uso

Use este site como sistema de publicação para documentação EmDash, conteúdo de migração, plugins, templates e atualizações de produto.

O que este site deve fazer

emdashcmseverything.com não deve se comportar como uma landing page genérica. Deve funcionar como camada pública de conhecimento e distribuição para o ecossistema EmDash.

Isso significa combinar vários papéis de conteúdo num sistema coerente:

  • explicar o que é o EmDash
  • ensinar como funciona
  • mostrar onde se encaixa
  • publicar plugins e templates
  • orientar migrações WordPress
  • anunciar progresso e releases do produto

Arquitetura da informação recomendada

A estrutura atual foi desenhada para apoiar esse modelo:

  • docs/docs para documentação perene
  • docs/use-cases para conteúdo de adoção orientado a cenários
  • docs/plugins para entradas do diretório de plugins
  • docs/templates para entradas do diretório de templates
  • docs/faq para atualizações, tutoriais e conteúdo editorial

Isso encaixa melhor do que empilhar tudo numa homepage de marketing única ou esconder informação de produto dentro de componentes de framework.

Como usar cada seção

Docs

Use esta seção para conteúdo durável e de alta intenção:

  • primeiros passos
  • explicações de recursos
  • notas de implantação
  • visões gerais de arquitetura
  • FAQ

Essas páginas devem responder às perguntas que as pessoas fazem antes e durante a avaliação.

Casos de uso

Use esta seção para traduzir capacidades do produto em contexto de comprador. O EmDash fica mais fácil de entender quando é enquadrado como encaixe para:

  • publicação editorial
  • documentação e bases de conhecimento
  • ecossistemas de plugins
  • negócios de templates

Esta seção deve ligar a forma do produto a resultados reais.

Plugins

Páginas de plugin devem parecer pequenas páginas de produto, não só release notes. Cada uma deve explicar:

  • o que o plugin faz
  • para quem é
  • status atual
  • preço ou disponibilidade
  • caminho de download
  • configuração e compatibilidade

Templates

Páginas de template devem facilitar comparar starters de site empacotados. Boas entradas incluem:

  • público-alvo
  • capturas de tela
  • detalhes da stack
  • versão e data de release
  • link de demo
  • link de download ou repositório

Blog e atualizações

Esta seção deve capturar movimento:

  • notas de versão
  • guias de migração
  • comentário de produto
  • tutoriais
  • estudos de caso

É o que mantém o site ativo e em acumulação.

Fluxo de publicação

Para este projeto, o fluxo saudável mais simples é:

  1. Adicionar ou revisar conteúdo em docs/
  2. Revisar o diff no Git
  3. Pré-visualizar localmente
  4. Implantar o site estático gerado no Cloudflare Pages

Esse fluxo é especialmente eficaz quando IA ajuda com rascunho, edição, reestruturação e consistência.

Por que esta estrutura funciona bem com IA

Edição com IA é muito mais confiável quando o site é construído em torno de:

  • arquivos MDX pequenos
  • frontmatter explícito
  • componentes de página reutilizáveis
  • padrões de rota estáveis
  • conteúdo separado do código de UI

Por isso a forma atual do site é intencionalmente content-first.

Como isso se relaciona com o próprio EmDash

Materiais oficiais do EmDash enfatizam coleções em runtime, edição no admin, plugins, armazenamento de mídia e portabilidade na nuvem. São pontos fortes do produto. Mas um site de ecossistema público não precisa de todos imediatamente.

O site estático é a camada pública de apresentação.

O runtime completo do EmDash é a próxima camada quando você precisar de:

  • editores não técnicos trabalhando no navegador
  • fluxos autenticados de contribuição
  • mídia gerenciada em runtime
  • automação mais rica ou fluxos de envio de plugins

Regra prática editorial

Cada página deve responder claramente a uma destas perguntas:

  • O que é o EmDash?
  • Por que não WordPress?
  • O que este plugin ou template faz?
  • Como migro?
  • Como implanto?
  • Por que vale adotar agora?

Se uma página não responde bem a nenhuma delas, provavelmente precisa de escopo mais apertado.