Recommit r373598 "[yaml2obj/obj2yaml] - Add support for SHT_LLVM_ADDRSIG sections."
[llvm-complete.git] / docs / MeetupGuidelines.rst
blobea16926c3b51c74500f196404509fec51327a19e
1 =====================================
2 How to start LLVM Social in your town
3 =====================================
5 Here are several ideas you can take into account when designing your specific
6 LLVM Social.
8 Before you start, it is essential to make sure that the meetup is as welcoming
9 as any other event related to LLVM. Therefore you shall follow LLVM's
10 `Code of Conduct <https://llvm.org/docs/CodeOfConduct.html>`_.
12 Other than that - your mileage may vary. Please adapt your social to what works
13 best for your specific situation.
15 General suggestions
16 -------------------
18 * We highly recommend that you join the official LLVM meetup organization. In
19   addition to covering the cost of the meetup, all LLVM meetups are advertised
20   together and easily found by potential attendees. Please contact
21   arnaud.degrandmaison@llvm.org for more details.
22 * Beware of cultural differences: what works well in one region may not work in
23   other part of the world.
24 * Do not be alone to organize the meetup. Try to work with a couple other
25   organizers. This is more motivating as an organizer, and this makes the
26   meetup more resilient over time.
27 * Each event can have a different form such as a social event, or
28   a hackathon/workshop, or a 'mini-conference' with one or more talks. You do
29   not have to stick to one format forever.
30 * Whatever format you choose, `LLVM Weekly <http://llvmweekly.org/>`_ is an
31   excellent topic starter: go through the 3-4 recent LLVM Weekly posts and
32   prepare a list of the most interesting/notable news and discuss them with the
33   group.
35 Advertisement
36 -------------
38 * Try to advertise via similar meetups/user groups
39 * Advertise your meetup on the mailing lists (llvm-dev, cfe-dev, lldb-dev,
40   ...). Feel free to post to all of them, or at least to llvm-dev.
41   But as these mailing lists have high traffic and some LLVM developers are not
42   very active on them, you may reach more interested people using the mailing
43   feature from meetup.com.
44 * Advertise the meetup on Twitter and mention
45   `@llvmweekly <http://twitter.com/llvmweekly>`_ and
46   `@llvmorg <http://twitter.com/llvmorg>`_.
47 * Announce the next meetup in advance, and remind in one week or so.
49 Tech talks
50 ----------
52 * It’s a great idea to have several talks scheduled for several upcoming
53   meetups to get the ball rolling.
54 * Keep looking for speakers far in advance, ideally you should have 2-3
55   speakers ready in the pipeline.
56 * Try to record the talks if possible. It adds visibility to the meetup and
57   just a good idea in general. Any modern smartphone or tablet should work, but
58   you can also get a camera. Though, it is recommended to get an external
59   microphone for better sound.
61 Where to host the meetup?
62 -------------------------
64 * Look around for bars/café with projectors.
65 * Talk to tech companies in the area.
66 * Some co-working spaces provide their facilities for non-profit (i.e., you do
67   not charge attendees any fees) meetups.
68 * Ask nearby universities or university departments.
70 How to pick the date?
71 ---------------------
73 * Make sure you do not clash with the similar meetups in the city (e.g.,
74   C++ user groups).
75 * Prefer not to have a meetup the same week when the other similar meetups
76   happen (e.g., it’s not a good idea to have LLVM meetup on Thursday after
77   C++ meetup on Wednesday).
78 * Meetups on weekends may attract people who live far away from the city,
79   but the people who live in the city may not attend.
80 * Make a poll, but beware that not every responder will join (we had ~20 votes
81   on the poll, while only ~8 people attended).