O Guia Rails nasceu da vontade de trazer mais pessoas para a comunidade, mas sem a barreira da língua inglesa. É uma forma de difundir o conhecimento e estimular a criação de materiais em português.
Neste repositório buscamos ajuda na tradução do guides.rubyonrails.org para pt-BR, já que lá temos uma excelente fonte de estudo e documentação de Ruby on Rails.
Você pode ver o conteúdo já traduzido em guiarails.com.br
Se você tem conhecimento em Rails ou ainda está aprendendo, nossas boas-vindas!
Temos um Guia sobre como contribuir com o projeto que você pode acessar aqui
Caso tenha dúvidas estamos aqui para ajudar!
Não é necessário verificar o HTML gerado pela sua contribuição, mas temos um Guia abaixo mostrando como isso é feito.
Ruby 2.5+
Não é preciso instalar as dependências do Rails para gerar a documentação,
mas temos que executar o comando abaixo para disponibilizar a rake que
gera os arquivos HTML a partir dos arquivos Markdown.
git submodule update --init
Assim que o Rails for clonado para o seu projeto você pode rodar um bin/setup
para instalar as dependências do Guia (não é necessário baixar todas as gems do
Rails, as dependências podem ser verificadas no arquivo Gemfile).
OBS.: temos arquivos de Docker (Dockerfile e docker-compose.yml) :slightly_smiling_face:
Com as dependências instaladas você pode rodar o comando:
rake guides:generate:html
Ele vai gerar os arquivos HTML e enviar o resultado para a pasta
./output/pt-BR
Por fim, para abrir o Guia navegue até essa pasta e abra o arquivo
index.html.erb:
Caso tenha qualquer dificuldade, abra uma issue.
Agradecemos sua contribuição. Cada uma é importante para fazer a comunidade crescer. Contribuindo com material em pt-BR trazemos mais pessoas para o ecossistema Ruby que tanto amamos.