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/docspara documentação perenedocs/use-casespara conteúdo de adoção orientado a cenáriosdocs/pluginspara entradas do diretório de pluginsdocs/templatespara entradas do diretório de templatesdocs/faqpara 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 é:
- Adicionar ou revisar conteúdo em
docs/ - Revisar o diff no Git
- Pré-visualizar localmente
- 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.