Guia de onboarding
Conclua o onboarding para configurar seu primeiro site de documentação: crie um projeto, conecte o GitHub, configure o docs.json e faça o primeiro build.
As 5 etapas
Quando você entrar pela primeira vez, o Jamdesk iniciará automaticamente sua avaliação gratuita de 14 dias do plano Pro.
- Acesso completo a todos os recursos
- A avaliação termina 14 dias após a ativação
Dê um nome ao seu projeto de documentação:
- Use um nome claro e descritivo (por exemplo, "Documentação da API", "Guia do usuário")
- Esse nome se torna parte da URL do seu site de documentação
- Você pode alterar o nome de exibição posteriormente nas configurações do projeto
O Jamdesk cria um novo repositório do GitHub a partir do Modelo inicial:
- Páginas de exemplo com conteúdo e componentes realistas
docs.jsonpré-configurado com navegação e identidade visual- Exemplo de especificação OpenAPI para documentação de referência da API
- Pronto para editar e enviar imediatamente
A CLI do Jamdesk permite o desenvolvimento local:
npm install -g jamdeskVocê pode ignorar esta etapa durante o onboarding e instalar a CLI a qualquer momento. Se ignorá-la, ainda poderá editar a documentação diretamente no GitHub.
Você já pode fazer o build! Edite sua documentação:
- Pela CLI: edite arquivos localmente com
jamdesk dev - Pelo GitHub: edite arquivos
.mdxdiretamente no seu repositório - No Jamdesk: alguns recursos do dashboard estão disponíveis, dependendo do plano
As alterações acionam automaticamente novos builds da documentação quando você faz push para o GitHub.
Após o onboarding
Depois de concluir o onboarding, você poderá:
- Criar projetos adicionais
- Convidar membros da equipe
- Ver análises
- Configurar domínios personalizados
Solução de problemas
Ignorei uma etapa. Posso voltar?
Você pode concluir o onboarding a qualquer momento no dashboard do seu projeto. Procure o cartão de onboarding para continuar de onde parou.
Escolhi o repositório do GitHub errado
Crie um novo projeto com o repositório correto. Você pode excluir o projeto antigo a qualquer momento.
Preciso de ajuda durante o onboarding
Entre em contato com o suporte a qualquer momento durante o processo.
