Instruções para contribuir com um tutorial

Traduzido por Maujor, site do Maujor

O site de tutoriais usa a tecnologia jekyll para renderizar suas páginas e todos os documentos do site são escritos com uso da sintaxe markdown. Para contribuir com um ou mais ( ;-) ) tutoriais siga os seguinte passos:

1. Dê um fork no repositório do github clicando no botão “Fork”.
2. Execute o comando git clone no seu fork.

Se você quer criar um novo tutorial

• Crie um arquivo denominado YYYY-MM-DD-nome_do_tutorial.markdown e salve no diretório _posts do seu fork.
• No início do arquivo recém criado use a sintaxe YAML para serializar alguns dados que são padronizados para os tutoriais. Veja um exemplo destes dados que se aplica a este documento que você está visualizando:

--- layout: default title: Contribua com um tutorial permalink: contributing ---

• A seguir escreva seu tutorial usando a sintaxe markdown.

Você pode tomar como base para seu tutorial a estrutura do tutorial Rails Girls App Tutorial.

Se você quer melhorar um tutorial já existente:

Faça as mudanças no arquivo que você quer mudar! Você não precisa criar um novo arquivo se você quer mudar alguma coisa em um arquivo que já existe.

Depois…

1. Commit seu tutorial para o seu repositório.
2. Feito o commit envie-o para seu fork.
3. Finalmente abra um pull request e nele acrescente uma breve descrição do seu tutorial. Feito!

Nossos mais efusivos agradecimentos por dedicar seu tempo em favor do enriquecimento dos conteúdos do site Rails Girls.

---

Outros Guias

• Handy cheatsheet for Ruby, Rails, console etc.
• Guia 1: Tutorial de Instalação para Rails Girls
• Guia 2: Tutorial para criação da app Rails Girls
• Guia 3: Como enviar para o GitHub
• Guia 4: Colocando seu app online em…
  • Heroku
  • OpenShift
  • Anynines
  • Engine Yard
• Guia 5: Funcionalidades de uma área de comentários para a app Rails Girls
• Guia 6: Adicione design à sua aplicação com HTML e CSS
• Guia 7: Thumbnails em listas de ideas
• Guia 8: Autenticação (para usuários) com Devise
• Guia 9: Adicionando Gravatar para a aplicação
• Guia 10: Melhorando seu design da sua aplicação com HTML e CSS
• Guia 11: Continuous Deployment
  • Testando seu app com RSpec
  • CD with Travis-CI
  • CD with Codeship
• Guia 12: Construindo um aplicativo de votação em Sinatra
• Guia 13: Construa um diário em Ruby on Rails
• Guia 14: Adicione back-end ao seu aplicativo (páginas de administração)
• Guia 15: Acesse explicações adicionais do app Rails Girls