that release branch (5.x in the previous example).

We also provide deprecation message triggered in the code base to help you with

.. caution::

Symfony Core Rules and Protocol Amendments

discretion of the **Project Leader**.

.. [1] Minor changes comprise typos, DocBlock fixes, code standards

.. note::

This policy is designed to enable a continuous upgrade path that allows one

be able to move PHP versions, OS or Symfony versions almost independently.

That's the reason why supporting the latest PHP versions or OS features is

considered as bug fixes.

Symfony being both a framework and library of components, it calls your

code and then your code might call it. This means you will always have

at least 2 parts, very often 3 in your stack traces when using Symfony:

(``bin/console`` or ``public/index.php`` in most cases), and ends when

reaching your code, most times in a command or in a controller found under

``src``. Then, either the exception is thrown in your code or in

library and ``acme/router`` the Composer package. If you plan on

reporting the bug, make sure to report it to the library throwing the

exception. ``composer home acme/router`` should lead you to the right

symfony/symfony`` when reporting a bug for any component.

Getting Stack Traces with Symfony

1. Are there several exceptions? If yes, the most interesting one is

often exception 1/n which, is shown *last* in the example below (it

2. Under the "Stack Traces" tab, you will find exceptions in plain

text, so that you can easily share them in e.g. bug reports. Make

sure to **remove any sensitive information** before doing so.

exposed in production. Getting a stack trace from your production

environment, although more involving, is still possible with solutions

that include but are not limited to sending them to an email address

Stack Traces in the CLI

This Code of Conduct applies both within project spaces and in public spaces

when an individual is representing the project or its community. Examples of

address, posting via an official social media account, or acting as an appointed

representative at an online or offline event. Representation of a project may be

further defined and clarified by CARE team members.

created related to the incidents.

CARE team members are expected to inform the CARE team and the reporters

Appealing the response

purpose we created a dedicated `Symfony Slack`_ channel called `#mentoring`_

to connect new contributors to long-time contributors. This is a great way

to get one-on-one advice on the entire process. These long-time contributors

.. _`Symfony Slack`: https://symfony.com/slack-invite

.. _`#mentoring`: https://symfony-devs.slack.com/messages/mentoring

When a feature implementation cannot be replaced with a better one without

breaking backward compatibility, Symfony deprecates the old implementation and

:ref:`conventions <contributing-code-conventions-deprecations>` document to

learn more about how deprecations are handled in Symfony.

welcoming place for everyone. **You are free to disagree with

someone's opinions, but don't be disrespectful.**

It's not about being right or wrong, but using what works.

Tone of Voice

* "We only provide integration with very popular projects (e.g. we integrate Bootstrap but not your own CSS framework)"

* "This would require adding lots of code and making lots of changes for a feature that doesn't look so important.

Asking for Changes

Rarely something is perfect from the start, while the code itself is good.

Again, understand the author already spent time on the issue and asking

for (small) changes may be misinterpreted or seen as a personal attack.

* "Please use 4 spaces instead of tabs", "This needs be on the previous line";

you don't have to use "Please" all the time. But it wouldn't hurt.

It may not seem like much, but saying "Thank you" does make others feel

a different way, to not escalate further.

If you want someone to mediate, please join the ``#contribs`` channel on `Symfony Slack`_,

Using Humor

Even if someone's explanation is "inviting to joke about it", it's a real

problem to them. Making jokes about this doesn't help with solving their

Final Words

whether the implementation is complete.

It is okay to do partial reviews! If you do a partial review, comment how far

Pick a pull request from the `PRs in need of review`_ and follow these steps:

A good first step might be to give a talk at a local user group to a

smaller crowd that one knows more intimately. A next step could be to

The best way to find people that can review your talk idea or slides is

the `#speaker-mentoring`_ channel on `Symfony Slack`_. There are many

Voting

The quorum of "yes" or "no" votes required for a decision to be considered valid

is at least 75% of active, appointed members of the guidance team - to abstain

from voting means that vote will not be counted towards the quorum.

guidance team members is required. Use or management of finances/donations

require at least a two-thirds majority to pass.

Check you out! You've made your first contribution to the Symfony documentation!

Somebody throw a party! Your first contribution took a little extra time because

your contributions will be much easier to complete.

Here is a **checklist** of steps that will guide you through your next

Frequently Asked Questions

Please be patient. It can take up to several days before your pull request can

These messages are translated into tens of languages thanks to the Symfony

community. Symfony adds new messages on a regular basis, so this is an ongoing

How to Contribute a Translation