Fórum

Portando discussões feitas em grupos (Facebook, Google Groups, Slack, Disqus) pra issues.

Disclaimer: As opiniões aqui publicadas são de inteira responsabilidade de seus autores e não refletem, necessariamente, o posicionamento da organização.

Propósito

Uma conversa no Twitter foi o gatilho que precisavamos.

Alguns posts em grupos de front-end em redes sociais geram debates legais que poderiam ser disponibilizados em local melhor estruturado para tal. A busca do Facebook em grupos, por exemplo, tem vários problemas. Discussões épicas foram perdidas, e pessoas que ingressam agora nos grupos não tem mais acesso a esses posts.

A ideia desse repositório é portar ou iniciar essas discussões nas issues. Estando no Github, fica mais fácil procurar respostas a perguntas já respondidas por esses grupos.

O objetivo é unificar todas as discussões em um só local e o Github foi o escolhido para isso.

Vantagens do Github

Espaço usado por quase todos os desenvolvedores
É uma rede social
A busca funciona muito bem
Escalável
Organizável

Diretrizes e Boas Práticas

Antes de criar uma issue você deve atentar para as seguintes diretrizes:

Pesquise

Uma habilidade essencial para os desenvolvedores é saber fazer boas pesquisas. Muitas das dúvidas de iniciantes podem ser respondidas com pesquisas simples, portanto antes de postar sua dúvida certifique-se de que fez as pesquisas necessárias e traga para dentro da issue os dados que encontrou e os dados que não encontrou sobre o assunto.

Pesquise no fórum

Utilize a função de busca no topo desse repositório (certifique-se de não estar em um fork)
Pesquise assuntos próximos, talvez sua dúvida possa ter sido respondida em alguma issue parecida

Pesquise na internet

Caso sua dúvida seja sobre uma linguagem ou ferramenta específica, busque sua dúvida na documentação oficial dessa linguagem/ferramenta
Caso o item acima não resolva, utilize preferêncialmente o Google
Tente pesquisar em inglês, nem que pra isso precise recorrer ao Google Translate
Dê preferência para resultados de documentações oficiais e fóruns especializados, exemplo:

Outros pontos

Escreva o português de forma correta e bem pontuado.
Evite sair do escopo inicial da issue. Caso necessário, crie uma nova e mencione o número.
Se precisar de ajuda em um código, forneça trechos, Gists, e lembre-se, ninguém tem a obrigação de resolver seu problema.
Não seja um monólogo que só fala de si. Interaja com as respostas, cite pessoas, gere uma discussão saudável e construtiva. Afinal, quanto mais informações, mais rico nosso ambiente será e ajudará mais pessoas.

Quando criar uma Issue?

Dúvidas

Concentre suas issues em problemas reais. Inclua detalhes sobre o que você tentou e exatamente o que você está tentando fazer.

O ideal é que antes de criar uma dúvida você tente resolver o problema sozinho, na grande maioria das vezes uma breve busca no Google pode te ajudar a encontrar uma solução.

Pergunte sobre:

Como resolver um determinado problema ex: Como alterar a cor de fundo de uma div com CSS.
Como executar uma determinada tarefa ex: Como consumir um webservice REST com JavaScript.
Como otimizar um trecho de código ex: Como percorrer todas as propriedades de um objeto rapidamente.

Lembre-se de pesquisar bastante antes de abrir uma issue, existem boas chances da sua dúvida já ter sido respondida e estar documentada pela internet.

Discussões

Discussões são sempre bem-vindas, ao formular uma issue, tente ser o mais direto possível sobre o que você pretende abordar, se necessário abra mais de uma thread, uma para cada assunto.

Ferramentas

Descobriu uma ferramenta, framework ou qualquer outro recurso que possa ajudar os membros do grupo? Não hesite em compartilhar conosco estamos ansiosos pela sua dica.

Geral

Caso seu post não se encaixe em nenhuma das categorias acima, não tem problema. Desde que ele trate sobre Front-End estaremos dispostos a discutir e ajudar.

Código de Conduta

Como qualquer grupo de discussões, existem algumas regras que devem ser seguidas para proporcionar uma melhor experiência à todos.

Respeite para ser respeitado. Não escreva algo que possa ofender alguém. Reflita se o texto não é agressivo/mal educado antes de enviar.
Mantenha as críticas nas idéias e não nas pessoas.
Não será permitido qualquer tipo de assédio ou discriminação relacionados a características ou escolhas pessoais, bem como bullying, sexismo, racismo ou qualquer outro tipo de ação que possa proporcionar constrangimento aos outros participantes.

Comporte-se profissionalmente. Os participantes que violarem tais regras serão convidados a se retirar ou banidos dada a gravidade de suas ações.

Linguagem

Todas as issues devem ser abertas e respondidas em pt-br.

Perguntas frequentes

Várias dúvidas e perguntas de como iniciar a carreira e por onde começar a estudar, nossa sugestão é que tu comeces lendo essas issues e logo depois abra uma nova com suas dúvidas:

#38 Referências sobre HTML e um monte de conhecimento sobre o que é uma linguagem de marcação e de transporte.
#270 Roadmap sobre por onde ir no JavaScript.
#90 Paradigmas de programação com JavaScript.
#229 Livros.

Como receber atualizações do Forum

Você pode receber atualizações do Forum no seu email ou via notificações do GitHub, basta clicar em Watch e, em seguida, clicar em Watching no canto superior direito da interface do site, próximo a sua foto de perfil.

Extra

No Slack Frontend Brasil tem o canal #forum que está integrado com o GitHub, desta forma, você sempre saberá quando alguém postou uma nova issue.

Entre e participe!

Badge	Link	Participar
	Frontend Brasil	Participar

kvnol / forum-1