Ir para o conteúdo

Nome do processo

Começar com a palavra "Como" e seguir com um verbo e o substantivo, ex: "Como criar template"

Propósito

Escrever qual a função do processo e resumidamente listar qual ações ele descreve. Ex:

Criar um template ou um exemplo padrão para ser usado ao se criar um novo processo.

Pré-requisitos

Listar todos os pré-requisitos para executar as ações descritas para esse processo. Ex:

  • Conta GitHub ativa
  • Acesso à organização e ao repositório da documentação com uma das seguintes permissões:
    • Owner
    • Admin
    • Membro com permissões específicas para criar processos

Processo

Descrição passo a passo para se executar a ação descrita pelo processo. Procure manter o processo conciso, sem expandir muito os tópicos. Entre 8 e 10 passos é o suficiente para qualquer processo, se for preciso muitos passos para executar o processo, considere criar um novo processo para os passos mais complexos. Ex:

Clonar o repositório da documentação no GitHub da organização

  1. Abrir um prompt de comando (cmd, PowerShell, WSL);
  2. Navegar até o diretório onde se deseja clonar o repositório localmente;
  3. Executar o comando:

    git clone git@github.com:bdbrid/documentacao.git
    

Criar uma branch para o novo template e abrir o projeto

  1. No prompt de comando navegue até o diretório do projeto e execute:

    git checkout -b novo-template
    
  2. Abra o projeto no editor de texto ou IDE de sua preferência;

Criar o arquivo do novo template

  1. Navegar até o diretório onde deseja criar o template;
  2. Criar um novo arquivo com a extensão ".md";
  3. Editar o arquivo usando sintaxe Markdown;

Fazer Commit e Push

  1. No prompt de comando, navegue até o diretório do projeto;
  2. Execute o comando:

    git commit -m "Criado o template"
    
  3. Envie as alterações para o repositório remoto usando os seguintes comandos:

    git fetch origin
    
    git push -u origin
    

Fazer Pull Request

  1. Acesse o repositório no GitHub da organização;
  2. Escolha a branch que você criou ("novo-template") e clique em Compare and pull request
  3. Preencha o título e a descrição para seu Pull Request;
  4. Clique em Create pull request;

Critérios de Sucesso

Especificar como saber se o processo foi executado com sucesso. Ex:

  • Template criado e enviado para revisão e inserção à página de documentação

FAQ

Listar possíveis dúvidas que podem surgir quando o procedimento for seguido. Ex:

O que fazer se o botão Compare e pull request não estiver visível?

Verifique suas permissões na organização. Contate um administrador se necessário.

Posso alterar os arquivos após fazer o Pull Request?

Sim, desde que seja alterado antes que as mudanças sofram o Merge com a branch principal.