Awesome BR possui um formato aberto a comunidade que deseja compartilhar conteúdo de qualidade frente às tecnologias mais atuais do mercado.
Nossa proposta é fortalecer a difusão das tecnologias de desenvolvimento web na língua portuguesa.
Nossa página http://awesome-br.github.io contém uma lista buscável de tecnologias, e cada tecnologia possui uma lista de links apontando para o melhor conteúdo em português da web. Todas as contribuições são feitas pela comunidade, todos podem participar.
Para participar é necessário conhecimento em git/github. Caso esteja com dificuldades, leia este artigo. Após realizar o fork deste projeto, faça suas contribuições de acordo com a tecnologia em questão, alterando o arquivo .json dentro da pasta sections. Por exemplo, se você deseja adicionar um link na categoria Laravel, edite o arquivo sections/laravel.json e faça o pull request.
Se você deseja adicionar uma nova tecnologia, abra uma nova issue requisitando a entrada da tecnologia em questão.
O formato para um novo item em qualquer tecnologia é:
{
"name": "Título do link",
"url": "Url do link",
"type": "Tipo",
"tags": [
"tags",
"tags"
],
"paid": false,
"author": {
"name": "Nome do autor",
"url": "Url do site do autor"
}
}O tipo pode ser: "artigo", "livro", "video", "screencast", "styleguide", "palestra", "tutorial", "dica", "slide", "vídeo", "documentação", "url", "curso", "guia", "pacote", "hangout", "slideshare", "apostila", "site". Outros tipos deverão ser requisitados abrindo uma ISSUE, pois o teste de Integração Contínua vai falhar.
Antes de enviar o pull request para o nosso repositório central, recomendamos testar a execução do site no seu computador. Isso pode ser feito através de um servidor web simples, como o http-server provido pelo node. Para isso, é preciso instalar o node e npm no seu sistema operacional, o que pode ser facilmente feito através do site oficial para Windows, ou através do sudo apt-get install npm no linux (debian).
Após instalar o node e o npm, instale as dependências (http-server) através do comando npm install, e, após a instalação, execute o comando npm run http-server.
A resposta que terá é algo semelhante a:
Starting up http-server, serving ./
Available on:
http:127.0.0.1:8081
http:192.168.0.132:8081
Copie a URL, juntamente com a porta, e abra o site no navegador.
Dica: Use ctrl+shift+r para atualizar o cache após alterar os arquivos .json.
Adicione o badge no repositório do seu projeto ou em seu blog! Exemplo:
Markdown:
[](http://awesome-br.com/#/laravel)`
HTML:
<a href="http://awesome-br.com/#/laravel"><img src="https://img.shields.io/badge/awesome--br.com-laravel-red.svg" alt="Awesome BR - Laravel" /></a>