Jamdesk Documentation logo

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

1
Iniciar avaliação

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
2
Criar projeto

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
3
Conectar o GitHub e criar documentação inicial

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.json pré-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
4
Instalar CLI

A CLI do Jamdesk permite o desenvolvimento local:

npm install -g jamdesk

Você 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.

5
Começar a editar

Você já pode fazer o build! Edite sua documentação:

  • Pela CLI: edite arquivos localmente com jamdesk dev
  • Pelo GitHub: edite arquivos .mdx diretamente 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á:

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.

Artigos relacionados

Primeiro build

Acione e verifique seu primeiro build

Tour pelo dashboard

Conheça o dashboard do Jamdesk