Como tirar dúvidas online?
Para tirar dúvidas durante os estudos no balta.io, você usa o nosso fórum no GitHub, um espaço único onde alunos e equipe conversam sobre os cursos.
Precisa de auxílio técnico em alguma aula? Então este guia mostra onde fica o fórum, como abrir uma discussão e como escrever uma pergunta que recebe resposta mais rápido.
Ao longo do texto, você também vai entender recursos do GitHub que facilitam a conversa, como imagens anexadas, blocos de código e menções.
O fórum para tirar dúvidas do balta.io
Em 13 de setembro, anunciamos a integração das discussões (Discussions) dos cursos em um novo fórum, ainda dentro do GitHub. Desde então, todas as conversas sobre os cursos ficam em um só lugar.
O novo fórum oferece uma visão unificada das dúvidas, dos anúncios e das enquetes. Com isso, conseguimos melhorar o conteúdo, coletar feedbacks e auxiliar melhor você.
No modelo anterior, cada curso tinha o próprio fórum. Na prática, isso duplicava perguntas e deixava confuso o processo de tirar dúvidas.
Hoje, quem chega ao fórum encontra perguntas de vários cursos reunidas. Assim, a chance de alguém já ter resolvido o mesmo problema aumenta bastante.
Por que o fórum fica no GitHub
O fórum usa o GitHub Discussions, um recurso pensado para comunidades de projetos. Segundo a documentação oficial do GitHub Discussions, ele permite fazer e responder perguntas, compartilhar informações, publicar anúncios e conversar sobre um projeto.
Essa escolha tem um motivo prático. Afinal, o GitHub já faz parte da rotina de quem desenvolve software, e praticamente todo curso do balta.io usa repositórios de código.
Além disso, participar do fórum ajuda você a ganhar familiaridade com uma ferramenta que vai usar no mercado. Se ainda não tem conta, vale seguir o guia de Git e GitHub: instalação, configuração e primeiros passos.
Outra vantagem é que as respostas ficam registradas no repositório. Assim, uma dúvida resolvida hoje continua útil para os próximos alunos que passarem pela mesma aula.
O GitHub Discussions também organiza as conversas em categorias. Por exemplo, existem formatos para perguntas e respostas, conversas abertas, anúncios e enquetes.
Como tirar dúvidas no fórum
O primeiro passo é acessar o Fórum por este link e clicar em Discussions. É ali que ficam todas as conversas abertas pelos alunos.
No menu lateral, aparecem as categorias do fórum. A categoria Anúncios traz notícias e a categoria Enquetes reúne votações, e as duas são exclusivas para administradores.
Esse comportamento vem do próprio GitHub. Em categorias de anúncio, apenas pessoas com permissão de manutenção ou administração criam discussões, mas qualquer pessoa pode comentar e responder.
Já a categoria Tira Dúvidas é a que você procura. Ela existe justamente para você tirar dúvidas sobre os cursos.
Selecione a opção Tira Dúvidas e pronto. Agora é só clicar em New Discussion e detalhar seu problema.
Antes de tirar dúvidas, pesquise no fórum
Antes de abrir uma nova discussão, use a busca do fórum. Como todas as perguntas ficam reunidas, outra pessoa pode já ter passado pelo mesmo erro e conseguido tirar dúvidas parecidas com as suas.
Pesquise pela mensagem de erro, pelo nome da aula ou pelo nome da tecnologia. Em muitos casos, a resposta já está lá, marcada como solução.
Se encontrar uma discussão parecida que não resolveu seu caso, comente nela com os seus detalhes. Dessa forma, o histórico fica concentrado e quem responder enxerga o contexto completo.
Se a busca não trouxer nada, tente variações da mesma pergunta. Por exemplo, pesquise só pelo trecho principal do erro, sem caminhos de arquivo ou nomes específicos do seu projeto.
Também vale reler a aula e conferir o repositório do curso. Muitas vezes, comparar seu código com o código da aula já revela a diferença.
Como criar uma nova discussão para tirar dúvidas
Se você nunca usou o GitHub ou nunca criou uma Discussion, fique tranquilo. A seguir, você confere o passo a passo completo.
Dentro da categoria Tira Dúvidas, clique em New Discussion.
Em seguida, descreva sua dúvida com um título conciso. No corpo, informe o curso, o módulo e a aula que você está fazendo.
Por fim, revise o texto e clique para iniciar a discussão. Pronto, agora é só aguardar, porque em breve retornaremos.
Como escrever uma boa pergunta para tirar dúvidas
Uma pergunta clara recebe resposta mais rápida, e isso vale para tirar dúvidas em qualquer comunidade. Por isso, vale seguir uma estrutura simples sempre que for tirar dúvidas no fórum.
O README do fórum orienta exatamente nesse sentido. Ele pede que você informe o curso e a aula, descreva o problema, explique como reproduzi-lo e inclua prints do erro e trechos de código relevantes.
Na prática, uma boa pergunta responde a quatro pontos:
- Onde você está: curso, módulo e aula.
- O que você tentou fazer: o objetivo daquele trecho de código.
- O que aconteceu: a mensagem de erro completa ou o comportamento inesperado.
- Como reproduzir: os passos e o código mínimo que geram o problema.
Evite títulos genéricos como "não funciona" ou "ajuda urgente". Em vez disso, use algo como "Erro de conexão com o banco na aula de migrations", que já indica o assunto.
Também evite colar o projeto inteiro. Quanto menor o trecho que reproduz o erro, mais fácil fica para alguém analisar.
Outra dica é informar versões. Por exemplo, diga qual versão do .NET, do sistema operacional ou do editor você usa, porque isso muda muitos comportamentos.
Anexe imagens do erro
Na hora de tirar dúvidas, anexar imagens do erro ajuda a resolver seu problema mais rápido. Basta clicar no rodapé da caixa de mensagem ou arrastar uma imagem para ela, que o GitHub faz o upload.
Segundo a documentação do GitHub, você também pode colar a imagem direto da área de transferência em muitos navegadores. Imagens e GIFs aceitam até 10 MB.
Não se assuste, porque a imagem não aparece no texto enquanto você escreve, apenas uma URL. Isso acontece porque o GitHub usa Markdown como formatação de texto.
Ao capturar a tela, mostre a mensagem de erro inteira e, se possível, a linha do código onde ela aparece. Recortes muito pequenos escondem justamente a informação que resolveria o problema.
Para ver o resultado final, use a aba de pré-visualização. Assim, você confere se a imagem e o texto ficaram como esperado antes de enviar.
Um cuidado importante: o fórum é público. Portanto, nunca publique senhas, chaves de API, connection strings ou dados pessoais nos prints e no código.
Adicione trechos de código
Código também ajuda muito a tirar dúvidas com precisão. Para isso, use três crases seguidas do nome da linguagem, escreva o código e feche com mais três crases.
No exemplo abaixo, usamos csharp como identificador da linguagem:
```csharp
var customer = new Customer("John");
Console.WriteLine(customer.Name);
```
O identificador ativa o destaque de sintaxe, o que deixa o código muito mais fácil de ler. De acordo com a documentação do GitHub, a plataforma usa o Linguist para reconhecer a linguagem e aplicar as cores.
Para citar um comando ou nome de classe dentro de uma frase, use apenas uma crase de cada lado. Assim, o texto entre as crases não recebe formatação.
A mesma técnica vale para mensagens de erro longas e stack traces. Colocar a saída do terminal dentro de um bloco de código preserva as quebras de linha e facilita a leitura.
Sempre cole o código como texto, e não como print. Dessa forma, quem for ajudar consegue copiar, testar e sugerir a correção.
Se quiser aprender mais sobre Markdown e documentação, o artigo sobre documentação com GitHub é um bom complemento.
Exemplo de pergunta bem escrita
Para deixar tudo mais concreto, veja como uma pergunta completa pode ficar. Repare que ela segue os quatro pontos da seção anterior.
Título: Erro ao executar a migration na aula de Entity Framework
Curso: nome do curso, módulo 3, aula 5.
Objetivo: criar a tabela de clientes no banco com a primeira migration.
Problema: ao rodar o comando da aula, o terminal exibe uma mensagem de erro de conexão (mensagem completa colada logo abaixo).
O que já tentei: conferi a connection string e reiniciei o banco, mas o erro continua.
Esse formato economiza várias idas e vindas. Afinal, quem lê já sabe onde você está, o que esperava e o que deu errado.
Compare com uma pergunta como "a migration não funciona, alguém ajuda?". Nesse caso, a primeira resposta será sempre um pedido de mais informações, e o tempo para tirar dúvidas dobra.
Acompanhe e edite a sua discussão
Depois de publicar, acompanhe a discussão pelas notificações do GitHub. Sempre que alguém comentar ou mencionar você, a plataforma avisa.
Se esquecer algum detalhe, edite a própria pergunta em vez de abrir outra. Assim, toda a informação fica em um só lugar.
Quando alguém pedir mais dados, responda no mesmo tópico. Da mesma forma, se você descobrir a solução sozinho, conte como resolveu, porque isso ajuda o próximo aluno a tirar dúvidas parecidas.
Se a resposta demorar, tenha paciência e confira se a pergunta tem todo o contexto necessário. Muitas vezes, acrescentar um detalhe que faltava destrava a conversa.
Evite abrir várias discussões para o mesmo problema. Além de espalhar o histórico, isso dificulta o trabalho de quem está respondendo.
Posso marcar o balta?
Claro, você pode usar o @ para me marcar sempre que precisar tirar dúvidas. Segundo o GitHub, quem é mencionado recebe uma notificação, inclusive quando a menção entra na edição de um comentário.
Use a menção com bom senso. Ou seja, marque quando a pergunta realmente precisar de atenção, e não em todo comentário.
Depois que a dúvida for respondida
Quando receber a resposta, teste a solução e conte o resultado na própria discussão. Esse retorno ajuda a fechar o assunto e orienta quem chegar depois.
No GitHub Discussions, o autor da discussão pode marcar um comentário como resposta. Então o GitHub destaca esse comentário para que outros visitantes encontrem a solução rapidamente.
Você também pode votar em discussões e comentários úteis com a seta de upvote. Com isso, as melhores respostas ganham visibilidade no fórum.
Por fim, se você souber ajudar outro aluno a tirar dúvidas, participe. Explicar um conceito para alguém é uma das melhores formas de consolidar o que você aprendeu.
Boas práticas para tirar dúvidas
Para fechar, reunimos as principais recomendações em uma lista rápida:
- Pesquise no fórum antes de abrir uma nova discussão.
- Escolha sempre a categoria Tira Dúvidas.
- Use um título específico, que descreva o problema.
- Informe curso, módulo e aula.
- Inclua a mensagem de erro completa.
- Cole o código como texto, com o identificador da linguagem.
- Anexe prints quando ajudarem a entender o problema.
- Remova senhas, chaves e dados pessoais antes de publicar.
- Marque a resposta que resolveu seu problema.
Lembre também que o fórum serve para tirar dúvidas técnicas sobre os cursos. Segundo o README do repositório, conteúdos fora desse escopo são removidos, e assuntos administrativos seguem por outro canal.
Conclusão
O fórum no GitHub concentra em um só lugar todas as conversas dos cursos do balta.io. Dessa forma, fica mais simples tirar dúvidas, encontrar respostas antigas e acompanhar anúncios.
O caminho é curto: acesse o repositório, abra Discussions, escolha Tira Dúvidas e clique em New Discussion. Depois, capriche no contexto, no código e nas imagens.
Quanto melhor a pergunta, mais rápida a resposta. Então aproveite o fórum e bons estudos!
FAQ
Onde fica o fórum do balta.io?
O fórum fica no repositório balta-io/forum no GitHub, na aba Discussions. A categoria para perguntas se chama Tira Dúvidas.
Preciso de uma conta no GitHub para perguntar?
Sim. Para criar uma discussão ou comentar, você precisa estar logado em uma conta do GitHub.
Posso criar discussões em Anúncios ou Enquetes?
Não. Essas categorias são exclusivas para administradores, mas você pode comentar nas publicações.
Como envio um print do erro?
Arraste a imagem para a caixa de mensagem, clique no rodapé dela ou cole a imagem direto. O GitHub faz o upload e insere um link em Markdown.
Como formato um trecho de código?
Use três crases seguidas do nome da linguagem, como csharp, e feche o bloco com mais três crases.
Posso marcar o balta na discussão?
Sim. Basta usar o @ seguido do usuário do GitHub, e a pessoa mencionada recebe uma notificação.