{{TOC}}

{{DOCVER 5.3=c06d6a2352ed8c767633aab9c20f2bf7d880c967 28.01.2017 5:00:51, 5.2=6b0b057ae6de3c88cb29188459e38383c622ec23 8.12.2016 23:00:15, 5.1=cdc24ba7426c5b11eb4d050706bd78c3ea4913cc 19.06.2016 20:08:01, 5.0=f6e862ba51a97f2bf9865f35fd5c522c14af93a1 31.07.2015 15:36:24}}

== Сообщения об ошибках ==
Чтобы стимулировать активное сотрудничество, Laravel настоятельно рекомендует отправлять запросы на исправления и улучшения, а не только отчёты об ошибках. "Отчёт об ошибке" также может быть отправлен в виде запроса на улучшение, содержащего проваленный тест.

А если вы отправляете отчёт об ошибке, то ваша заявка должна содержать заголовок и понятное описание проблемы. Вам следует прикрепить как можно больше сопутствующей информации и пример кода, демонстрирующий проблему. Цель отчёта - упростить вам (и остальным) возможность воспроизвести ошибку и разработать исправление.

Помните, отчёт об ошибке создаётся с целью объединения людей, столкнувшихся с той же проблемой, для её решения. Не ждите, что отчёт автоматически приведёт к скорейшему решению, и остальные разработчики кинуться решать проблему. Создание отчёта служит началом для вас и остальных в решении проблемы.

Исходный код Laravel расположен на Github. Вот репозитории каждого из проектов Laravel:
  * ((https://github.com/laravel/framework Laravel Framework))
  * ((https://github.com/laravel/laravel Laravel Application))
  * ((https://github.com/laravel/docs Laravel Documentation))
  * ((https://github.com/laravel/cashier Laravel Cashier))
  * ((https://github.com/laravel/cashier-braintree Laravel Cashier для Braintree))
  * ((https://github.com/laravel/envoy Laravel Envoy))
  * ((https://github.com/laravel/homestead Laravel Homestead))
  * ((https://github.com/laravel/settler Laravel Homestead Build Scripts))
  * ((https://github.com/laravel/passport Laravel Passport))
  * ((https://github.com/laravel/scout Laravel Scout))
  * ((https://github.com/laravel/socialite Laravel Socialite))
  * ((https://github.com/laravel/laravel.com Laravel Website))
  * ((https://github.com/laravel/art Laravel Art))

== Обсуждение разработки ядра ==
Вы можете предложить новую функцию или исправление существующего поведения Laravel на внутренней ((https://github.com/laravel/internals/issues доске задач)). Пожалуйста, когда предлагаете новую функцию, напишите хотя бы часть необходимого для её реализации кода.

Обсуждение относительно ошибок, новых функций и реализации существующих функций ведётся на канале %%(t)#internals%% в ((https://larachat.co/ LaraChat)) команды Slack. Тэйлор Отвелл, создатель Laravel, обычно присутствует на канале по будням с 8 утра до 5 вечера (по чикагскому времени UTC-06:00), а иногда и в другое время.

== Какая ветка? ==
**Все** исправления ошибок должны отправляться в последнюю стабильную ветку. Исправления ошибок **никогда** не должны отправляться в ветку %%(t)master%%, только если они относятся к функциям, которые есть только в следующем релизе.

**Минорные** функции, которые **полностью обратно совместимы** с текущим релизом Laravel, могут быть отправлены в последнюю стабильную ветку.

**Мажорные** новые функции должны всегда отправляться в ветку %%(t)master%%, которая содержит следующий релиз Laravel.

Если вы не уверены к каким функциям относится ваша, мажорным или минорным, спросите об этом Тэйлора Отвелла на канале %%(t)#internals%% в ((https://larachat.co/ LaraChat)) команды Slack.

== Уязвимости безопасности ==
Если вы обнаружите уязвимость в безопасности Laravel, пожалуйста, напишите об этом Тэйлору Отвеллу на почту taylor@laravel.com. Все уязвимости будут оперативно устранены.

== Стандарты кода ==
Laravel следует стандарту автозагрузки ((https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-4-autoloader.md PSR-4)) и стандарту написания кода ((https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md PSR-2)).

=== PHPDoc ===
Ниже приведён пример правильного блока документации Laravel. Обратите внимание, что после атрибута %%@param%% стоят два пробела, тип аргумента, ещё два пробела и в конце имя переменной:
%%
/**
 * Register a binding with the container.
 *
 * @param  string|array  $abstract
 * @param  \Closure|string|null  $concrete
 * @param  bool  $shared
 * @return void
 */
public function bind($abstract, $concrete = null, $shared = false)
{
  //
}
%%

=== StyleCI ===
Если ваш стиль написания кода не идеален, не волнуйтесь! ((https://styleci.io/ StyleCI)) автоматически поместит в репозиторий Laravel все исправления стиля после размещения запроса на включение. Это позволяет нам сконцентрироваться на содержании, а не форме.