Este repositório é destinado à artigos de alunos do balta.io, veja como você pode contribuir abaixo.
O nosso Blog tem como principal conteúdo os artigos técnicos produzidos pelo próprio André Baltieri, pessoas da equipe balta.io e alunos da plataforma.
Sabendo qual o tema que pretende abordar, chegou a hora de apresentar a sua proposta. Para isto você deve preencher os dados do template aqui!. É importante ler corretamente e preencher as informações conforme esperado.
Frequêntemente nos deparamos com propostas onde o título do issue ainda está "TíTULO DO ARTIGO AQUI" como no template, isto passa uma primeira impressão de que o autor não está dando a atenção correta ao que está fazendo e consequêntemente a credibilidade é afetada. Entenda melhor é esperado na submissão da sua proposta:
Antes de escrever é importante alinharmos um tema. Os temas que mais fazem sentido para as tecnologias que trabalhamos serão mais aceitos. VocÊ pode escrever sobre ferramentas, metodologisa, arquitetura, bibliotecas, frameworks e etc.
Então no tema do artigo você deve inserir um título que considere eficaz e direto quanto ao conteúdo que deseja escrever.
Neste tópico o objetivo é que resuma seu objetivo para o artigo envolvendo o assunto que será abordado, os processos que utilizadá, suas referências, onde pretende chegar e qual a finalidade do artigo.
A data de submissão do artigo se refere à data em que você concluirá o desenvolvimento do artigo. Como se trata de uma previsão, esperamos que uma data seja determinada mas obviamente caso aconteça algo durante o processo você pode retificar esta data. No caso de retificação esperamos que nos notifique para que possamos trabalhar na agenda de conteúdo sem surpresas.
Os artigos devem estar organizados por tópicos e parágrafos corretamente. Os trechos de código devem estar inseridos dentro das marcações de código referênciando a linguagem corretamente para exibir o highlight. Exemplo:
Código C# (CSharp):
Console.WriteLine("Hello World!");Após o tema ter sido aceito, você pode começar a escrever seu artigo, ele tem que ser no formato Markdown e conter pelo menos 1000 palavras. Lembre-se de adicionar sumário e tópicos corretamente em seu artigo.
NOTA 1: Caso tenha usado outros artigos, documentação e pesquisas durante o processo de desenvolvimento do seu artigo. Adicione as referências no final do seu artigo.
NOTA 2: Caso ainda tenha dúvidas e/ou um exemplo aplicado te auxilie melhor a entender, utilize este artigo como exemplo. Ele contém sumário, tópicos organizados, parágrafos, imagens e referências.
Utilize imagens grandes e visíveis, e não se esqueça de salvá-las dentro de uma pasta imagens no mesmo diretório do seu artigo, vamos precisar dos arquivos destas imagens para colocar seu artigo no ar.
Para publicar seu artigo será necessário fazer um fork do nosso blog clicando no botão fork localizado no canto superior direito da tela abaixo do ícone de usuário do seu GitHub:
Depois basta imcorporar seu artigo ao fork criado no seu perfil e fazer um Pull request para este repositório, lembrece de seguir os passos: Criar uma pasta (Não usar espaços ou caracteres especiais no nome da pasta) com os seguintes arquivos:
- nome-do-artigo/index.md -> Seu artigo
- nome-do-artigo/images/ -> Imagens do seu artigo
Nós vamos priorizar artigos escritos exclusivamente para nossa plataforma.