Contribution Guide

Relatar Reports

Para encoragar a ativa colaboração, Laravel encoraja fortemente pull requests, não apenas relatório de bugs. "Relatar Bugs" pode também ser enviada em forma de pull request contendo um teste unitário que falhou.

No entanto, se você enviar um relatório de bug, o problema deve conter um título e uma descrição clara do problema. Você deve incluir o máximo de informação relevante possível e uma amostra do código que mostra o problema. O objetivo de relatório de bugs é tonar mais fácil para si mesmo - e outros - replicar o bug e desenvolver a solução.

Lembre-se, relatório de bugs foi criada com o intúito que outras pessoas com o seu mesmo problemas irão ser aptas de colaborar com você para resolver isto. Não espere que a relatório de bug verá qualquer atividade ou qualquer outra coisa e irá pular par resolver isto. Criar um relatório bug serve para ajudar a você mesmo e outros que começaram no caminho da solução de problemas.

O código fonte do Laravel é gerenciado no Github, e lá existem repositórios para cada projeto Laravel:

Discurssão sobre o Desenvolvimento do Core

Discurssão sobre bugs, novos recursos, e implementação de funcionalidade existentes ocorre no canal do IRC #laravel-dev(Freenode). Taylor Otwell, o mantenedor to Laravel, é normalmente presente no canal nos dias de semana das 8h da manhã as 5 da tarde (UTC-06:00 or America/Chicago), e esporadicamente presente no canal em outros horários.

O canal do IRC #laravel-dev é aberto da todos. Todos são bem vindo as se juntar o canal tanto seja para participar ou simplesmente observar as discussões.

Qual Branch?

Todas as correções de bugs devem ser enviadas para o último branch estável. Correções de bugs nunca devem ser enviadas para a branch master a menos que enviem correçoes de funcionalidades que existem no proxímo lançamento.

Funcinalidades de Menor proporção que são totalmente compatíveis com as branchs anteriores e também com a branch atual do Laravel poderão ser enviada para última branch estável do Laravel.

Funcionalidades de maior proporção novos recursos devem ser sempre enviados para a branch master, que contém a próxima versão do Laravel.

Se você incerto se sua funcionalidade é qualificada como principal ou menor, por favor pergunte a Taylor Otwell no canal do IRC #laravel-dev (Freenode).

Vulnerabilidades de Segurança

Se você discobrir uma falha de segurança no Lravel, por favor mande um e-mail para Taylor Otwell no endereço taylor@laravel.com. Todas as falhas de segurança serão prontamente corrigidas.

Estilo de Código

Laravel segue os padrões de código PSR-4 e a PSR-1. Em adição a estas normas, os seguintes padrões devem ser seguidos:

  • A declaração de namespace deve estar na mesma linha que <?php.
  • A abertura de classe { deve estar na mesma linha que o nome da classe.
  • Funções e controles de estrutura devem usar chaves no estilo Allman.
  • Idente com tabs, alinhe com espaços.