1Getting Involved
2================
3
4LLVM welcomes contributions of all kinds. To get started, please review the following topics:
5
6.. contents::
7   :local:
8
9.. toctree::
10   :hidden:
11
12   Contributing
13   DeveloperPolicy
14   CodeReview
15   SupportPolicy
16   SphinxQuickstartTemplate
17   Phabricator
18   HowToSubmitABug
19   BugLifeCycle
20   CodingStandards
21   GitBisecting
22   GitRepositoryPolicy
23
24:doc:`Contributing`
25   An overview on how to contribute to LLVM.
26
27:doc:`DeveloperPolicy`
28   The LLVM project's policy towards developers and their contributions.
29
30:doc:`CodeReview`
31   The LLVM project's code-review process.
32
33:doc:`SupportPolicy`
34   The LLVM support policy for core and non-core components.
35
36:doc:`SphinxQuickstartTemplate`
37  A template + tutorial for writing new Sphinx documentation. It is meant
38  to be read in source form.
39
40:doc:`Phabricator`
41   Describes how to use the Phabricator code review tool hosted on
42   http://reviews.llvm.org/ and its command line interface, Arcanist.
43
44:doc:`HowToSubmitABug`
45   Instructions for properly submitting information about any bugs you run into
46   in the LLVM system.
47
48:doc:`BugLifeCycle`
49   Describes how bugs are reported, triaged and closed.
50
51:doc:`CodingStandards`
52  Details the LLVM coding standards and provides useful information on writing
53  efficient C++ code.
54
55:doc:`GitBisecting`
56  Describes how to use ``git bisect`` on LLVM's repository.
57
58:doc:`GitRepositoryPolicy`
59   Collection of policies around the git repositories.
60
61.. _development-process:
62
63Development Process
64-------------------
65
66Information about LLVM's development process.
67
68.. toctree::
69   :hidden:
70
71   Projects
72   HowToReleaseLLVM
73   Packaging
74   ReleaseProcess
75   HowToAddABuilder
76   ReleaseNotes
77
78:doc:`Projects`
79  How-to guide and templates for new projects that *use* the LLVM
80  infrastructure.  The templates (directory organization, Makefiles, and test
81  tree) allow the project code to be located outside (or inside) the ``llvm/``
82  tree, while using LLVM header files and libraries.
83
84:doc:`HowToReleaseLLVM`
85  This is a guide to preparing LLVM releases. Most developers can ignore it.
86
87:doc:`ReleaseProcess`
88  This is a guide to validate a new release, during the release process. Most developers can ignore it.
89
90:doc:`HowToAddABuilder`
91   Instructions for adding new builder to LLVM buildbot master.
92
93:doc:`Packaging`
94   Advice on packaging LLVM into a distribution.
95
96:doc:`Release notes for the current release <ReleaseNotes>`
97   This describes new features, known bugs, and other limitations.
98
99.. _mailing-lists:
100
101Mailing Lists
102-------------
103
104If you can't find what you need in these docs, try consulting the mailing
105lists. In addition to the traditional mailing lists there is also a
106`Discourse server <https://llvm.discourse.group>`_ available.
107
108`Developer's List (llvm-dev)`__
109  This list is for people who want to be included in technical discussions of
110  LLVM. People post to this list when they have questions about writing code
111  for or using the LLVM tools. It is relatively low volume.
112
113  .. __: http://lists.llvm.org/mailman/listinfo/llvm-dev
114
115`Commits Archive (llvm-commits)`__
116  This list contains all commit messages that are made when LLVM developers
117  commit code changes to the repository. It also serves as a forum for
118  patch review (i.e. send patches here). It is useful for those who want to
119  stay on the bleeding edge of LLVM development. This list is very high
120  volume.
121
122  .. __: http://lists.llvm.org/pipermail/llvm-commits/
123
124`Bugs & Patches Archive (llvm-bugs)`__
125  This list gets emailed every time a bug is opened and closed. It is
126  higher volume than the LLVM-dev list.
127
128  .. __: http://lists.llvm.org/pipermail/llvm-bugs/
129
130`Test Results Archive (llvm-testresults)`__
131  A message is automatically sent to this list by every active nightly tester
132  when it completes.  As such, this list gets email several times each day,
133  making it a high volume list.
134
135  .. __: http://lists.llvm.org/pipermail/llvm-testresults/
136
137`LLVM Announcements List (llvm-announce)`__
138  This is a low volume list that provides important announcements regarding
139  LLVM.  It gets email about once a month.
140
141  .. __: http://lists.llvm.org/mailman/listinfo/llvm-announce
142
143.. _online-sync-ups:
144
145Online Sync-Ups
146---------------
147
148A number of regular calls are organized on specific topics. It should be
149expected that the range of topics will change over time. At the time of
150writing, the following sync-ups are organized:
151
152.. list-table:: LLVM regular sync-up calls
153   :widths: 25 25 25 25
154   :header-rows: 1
155
156   * - Topic
157     - Frequency
158     - Calendar link
159     - Minutes/docs link
160   * - RISC-V
161     - Every 2 weeks on Thursday
162     - `ics <https://calendar.google.com/calendar/ical/lowrisc.org_0n5pkesfjcnp0bh5hps1p0bd80%40group.calendar.google.com/public/basic.ics>`__
163       `gcal <https://calendar.google.com/calendar/b/1?cid=bG93cmlzYy5vcmdfMG41cGtlc2ZqY25wMGJoNWhwczFwMGJkODBAZ3JvdXAuY2FsZW5kYXIuZ29vZ2xlLmNvbQ>`__
164     -
165   * - Scalable Vectors and Arm SVE
166     - Monthly, every 3rd Tuesday
167     - `ics <https://calendar.google.com/calendar/ical/bjms39pe6k6bo5egtsp7don414%40group.calendar.google.com/public/basic.ics>`__
168       `gcal <https://calendar.google.com/calendar/u/0/[email protected]>`__
169     - `Minutes/docs <https://docs.google.com/document/d/1UPH2Hzou5RgGT8XfO39OmVXKEibWPfdYLELSaHr3xzo/edit>`__
170   * - ML Guided Compiler Optimizations
171     - Monthly
172     -
173     - `Minutes/docs <https://docs.google.com/document/d/1JecbplF09l3swTjze-UVeLh4L48svJxGVy4mz_e9Rhs/edit?usp=gmail#heading=h.ts9cmcjbir1j>`__
174   * - `LLVM security group <https://llvm.org/docs/Security.html>`__
175     - Monthly, every 3rd Tuesday
176     - `ics <https://calendar.google.com/calendar/ical/eoh3m9k1l6vqbd1fkp94fv5q74%40group.calendar.google.com/public/basic.ics>`__
177       `gcal <https://calendar.google.com/calendar/embed?src=eoh3m9k1l6vqbd1fkp94fv5q74%40group.calendar.google.com>`__
178     - `Minutes/docs <https://docs.google.com/document/d/1GLCE8cl7goCaLSiM9j1eIq5IqeXt6_YTY2UEcC4jmsg/edit?usp=sharing>`__
179   * - `CIRCT <https://github.com/llvm/circt>`__
180     - Weekly, on Wednesday
181     -
182     - `Minutes/docs <https://docs.google.com/document/d/1fOSRdyZR2w75D87yU2Ma9h2-_lEPL4NxvhJGJd-s5pk/edit#heading=h.mulvhjtr8dk9>`__
183   * - `MLIR <https://mlir.llvm.org>`__ design meetings
184     - Weekly, on Thursdays
185     -
186     - `Minutes/docs <https://docs.google.com/document/d/1y_9f1AbfgcoVdJh4_aM6-BaSHvrHl8zuA5G4jv_94K8/edit#heading=h.cite1kolful9>`__
187   * - flang
188     - Multiple meeting series, `documented here <https://github.com/llvm/llvm-project/blob/main/flang/docs/GettingInvolved.md#calls>`__
189     -
190     -
191   * - OpenMP
192     - Multiple meeting series, `documented here <https://openmp.llvm.org/docs/SupportAndFAQ.html>`__
193     -
194     -
195   * - LLVM Alias Analysis
196     - Every 4 weeks on Tuesdays
197     - `ics <http://lists.llvm.org/pipermail/llvm-dev/attachments/20201103/a3499a67/attachment-0001.ics>`__
198     - `Minutes/docs <https://docs.google.com/document/d/17U-WvX8qyKc3S36YUKr3xfF-GHunWyYowXbxEdpHscw>`__
199   * - Windows/COFF related developments
200     - Every 2 months on Thursday
201     -
202     - `Minutes/docs <https://docs.google.com/document/d/1A-W0Sas_oHWTEl_x_djZYoRtzAdTONMW_6l1BH9G6Bo/edit?usp=sharing>`__
203   * - Vector Predication
204     - Every 2 weeks on Tuesdays, 3pm UTC
205     -
206     - `Minutes/docs <https://docs.google.com/document/d/1q26ToudQjnqN5x31zk8zgq_s0lem1-BF8pQmciLa4k8/edit?usp=sharing>`__
207   * - LLVM Pointer Authentication
208     - Every month on Mondays
209     - `ics <https://calendar.google.com/calendar/ical/fr1qtmrmt2s9odufjvurkb6j70%40group.calendar.google.com/public/basic.ics>`__
210     - `Minutes/docs <https://docs.google.com/document/d/14IDnh3YY9m6Ej_PaRKOz8tTTZlObgtLl8mYeRbytAec/edit?usp=sharing>`__
211   * - MemorySSA in LLVM
212     - Every 8 weeks on Mondays
213     - `ics <https://calendar.google.com/calendar/ical/c_1mincouiltpa24ac14of14lhi4%40group.calendar.google.com/public/basic.ics>`__
214       `gcal <https://calendar.google.com/calendar/embed?src=c_1mincouiltpa24ac14of14lhi4%40group.calendar.google.com>`__
215     - `Minutes/docs <https://docs.google.com/document/d/1-uEEZfmRdPThZlctOq9eXlmUaSSAAi8oKxhrPY_lpjk/edit#>`__
216
217IRC
218---
219
220Users and developers of the LLVM project (including subprojects such as Clang)
221can be found in #llvm on `irc.oftc.net <irc://irc.oftc.net/llvm>`_.
222
223This channel has several bots.
224
225* Buildbot reporters
226
227  * llvmbb - Bot for the main LLVM buildbot master.
228    http://lab.llvm.org:8011/console
229  * smooshlab - Apple's internal buildbot master.
230
231* robot - Bugzilla linker. %bug <number>
232
233* clang-bot - A `geordi <http://www.eelis.net/geordi/>`_ instance running
234  near-trunk clang instead of gcc.
235
236In addition to the traditional IRC there is a
237`Discord <https://discord.com/channels/636084430946959380/636725486533345280>`_
238chat server available. To sign up, please use this
239`invitation link <https://discord.com/invite/xS7Z362>`_.
240
241
242.. _meetups-social-events:
243
244Meetups and social events
245-------------------------
246
247.. toctree::
248   :hidden:
249
250   MeetupGuidelines
251
252Besides developer `meetings and conferences <https://llvm.org/devmtg/>`_,
253there are several user groups called
254`LLVM Socials <https://www.meetup.com/pro/llvm/>`_. We greatly encourage you to
255join one in your city. Or start a new one if there is none:
256
257:doc:`MeetupGuidelines`
258
259.. _community-proposals:
260
261Community wide proposals
262------------------------
263
264Proposals for massive changes in how the community behaves and how the work flow
265can be better.
266
267.. toctree::
268   :hidden:
269
270   CodeOfConduct
271   Proposals/GitHubMove
272   BugpointRedesign
273   Proposals/LLVMLibC
274   Proposals/TestSuite
275   Proposals/VariableNames
276   Proposals/VectorizationPlan
277   Proposals/VectorPredication
278
279:doc:`CodeOfConduct`
280   Proposal to adopt a code of conduct on the LLVM social spaces (lists, events,
281   IRC, etc).
282
283:doc:`Proposals/GitHubMove`
284   Proposal to move from SVN/Git to GitHub.
285
286:doc:`BugpointRedesign`
287   Design doc for a redesign of the Bugpoint tool.
288
289:doc:`Proposals/LLVMLibC`
290   Proposal to add a libc implementation under the LLVM project.
291
292:doc:`Proposals/TestSuite`
293   Proposals for additional benchmarks/programs for llvm's test-suite.
294
295:doc:`Proposals/VariableNames`
296   Proposal to change the variable names coding standard.
297
298:doc:`Proposals/VectorizationPlan`
299   Proposal to model the process and upgrade the infrastructure of LLVM's Loop Vectorizer.
300
301:doc:`Proposals/VectorPredication`
302   Proposal for predicated vector instructions in LLVM.
303