diff --git a/contributing/community/index.rst b/contributing/community/index.rst new file mode 100644 index 00000000000..904e342963f --- /dev/null +++ b/contributing/community/index.rst @@ -0,0 +1,8 @@ +Contributing Code +================= + +.. toctree:: + :maxdepth: 2 + + irc + other diff --git a/contributing/community/irc.rst b/contributing/community/irc.rst new file mode 100644 index 00000000000..0f5935a9b2e --- /dev/null +++ b/contributing/community/irc.rst @@ -0,0 +1,42 @@ +IRC Meetings +============ + +The purpose of this meeting is to discuss topics in real time with many of the Symfony2 devs. + +Anyone may propose topics on the symfony-dev mailinglist until 24 hours before the meeting, ideally including well +prepared relevant information via some URL. 24 hours before the meeting a link to a `doodle`_ will be posted including +a list of all proposed topics. Anyone can vote on the topics until the beginning of the meeting to define the order in +the agenda. Each topic will be timeboxed to 15mins and the meeting lasts one hour, leaving enough time for at least 4 +topics. + +.. caution:: + Note that its not the expected goal of them meeting to find final solutions, but more to ensure that there is a + common understanding of the issue at hand and move the discussion forward in ways which are hard to achieve with + less real time communication tools. + +Meetings will happen each Thursday at 17:00 CET (+01:00) on the #symfony-dev channel on the Freenode IRC server. + +The IRC `logs`_ will later be published on the trac wiki, which will include a short summary for each of the topics. +Tickets will be created for any tasks or issues identified during the meeting and referenced in the summary. + +Some simple guidelines and pointers for participation: + + * Its possible to change votes until the beginning of the meeting by clicking on "Edit an entry" + * At doodle will be closed for voting at the beginning of the meeting + * Agenda is defined by which topics got the most votes in the doodle, or whichever was proposed first in case of a tie + * At the beginning of the meeting one person will identify him/herself as the moderator + * The moderator is essentially responsible for ensurign the 15min timebox and ensuring that tasks are clearly identified + * Usually the moderator will also handle writing the summary and creating trac tickets unless someone else steps up + * Anyone can join and is explicitly invited to participate + * Ideally one should familiarize oneself with the proposed topic before the meeting + * When starting on a new topic the proposer is invited to start things off with a few words + * Anyone can then comment as they see fit + * Depending on how many people participate one should potentially retrain oneself from pushing a specific argument too hard + * Remember the IRC `logs`_ will be published later on, so people have the chance to review comments later on once more + * People are encouraged to raise their hand to take on tasks defined during the meeting + +Here is an `example`_ doodle. + +.. _doodle: http://doodle.com +.. _logs: http://trac.symfony-project.org/wiki/Symfony2IRCMeetingLogs +.. _example: http://doodle.com/4cnzme7xys3ay53w diff --git a/contributing/community/other.rst b/contributing/community/other.rst new file mode 100644 index 00000000000..645e53d5af5 --- /dev/null +++ b/contributing/community/other.rst @@ -0,0 +1,14 @@ +Other Resources +=============== + +In order to follow what is happening in the community you might find these additional resources helpful + + * List of open `pulls`_ requests + * List of recent `commits`_ list + * List of open `bugs`_ + * List of open source `bundles`_ + +.. _pulls: https://github.com/fabpot/symfony/pulls +.. _commits: https://github.com/fabpot/symfony/commits/master +.. _bugs: http://trac.symfony-project.org/report/24 +.. _bundles: http://symfony2bundles.org/ diff --git a/contributing/index.rst b/contributing/index.rst index 60e00df3c2d..f36524b2808 100644 --- a/contributing/index.rst +++ b/contributing/index.rst @@ -8,5 +8,6 @@ Contribute to Symfony2: code/index documentation/index + community/index .. include:: map.rst.inc diff --git a/contributing/map.rst.inc b/contributing/map.rst.inc index 7306a890ecd..e6bd61dab2b 100644 --- a/contributing/map.rst.inc +++ b/contributing/map.rst.inc @@ -13,3 +13,8 @@ * :doc:`Format ` | * :doc:`Translations ` | * :doc:`License ` + +* **Community**: + + * :doc:`IRC Meetings ` | + * :doc:`Other Resources ` |