Add guidelines/recommendations for organizers of LLVM Socials

Differential Revision: https://reviews.llvm.org/D61550

git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@360651 91177308-0d34-0410-b5e6-96231b3b80d8

diff --git a/docs/MeetupGuidelines.rst b/docs/MeetupGuidelines.rst
new file mode 100644 (file)
index 0000000..ea16926
--- /dev/null
+++ b/docs/MeetupGuidelines.rst
@@ -0,0 +1,82 @@
+=====================================
+How to start LLVM Social in your town
+=====================================
+
+Here are several ideas you can take into account when designing your specific
+LLVM Social.
+
+Before you start, it is essential to make sure that the meetup is as welcoming
+as any other event related to LLVM. Therefore you shall follow LLVM's
+`Code of Conduct <https://llvm.org/docs/CodeOfConduct.html>`_.
+
+Other than that - your mileage may vary. Please adapt your social to what works
+best for your specific situation.
+
+General suggestions
+-------------------
+
+* We highly recommend that you join the official LLVM meetup organization. In
+  addition to covering the cost of the meetup, all LLVM meetups are advertised
+  together and easily found by potential attendees. Please contact
+  arnaud.degrandmaison@llvm.org for more details.
+* Beware of cultural differences: what works well in one region may not work in
+  other part of the world.
+* Do not be alone to organize the meetup. Try to work with a couple other
+  organizers. This is more motivating as an organizer, and this makes the
+  meetup more resilient over time.
+* Each event can have a different form such as a social event, or
+  a hackathon/workshop, or a 'mini-conference' with one or more talks. You do
+  not have to stick to one format forever.
+* Whatever format you choose, `LLVM Weekly <http://llvmweekly.org/>`_ is an
+  excellent topic starter: go through the 3-4 recent LLVM Weekly posts and
+  prepare a list of the most interesting/notable news and discuss them with the
+  group.
+
+Advertisement
+-------------
+
+* Try to advertise via similar meetups/user groups
+* Advertise your meetup on the mailing lists (llvm-dev, cfe-dev, lldb-dev,
+  ...). Feel free to post to all of them, or at least to llvm-dev.
+  But as these mailing lists have high traffic and some LLVM developers are not
+  very active on them, you may reach more interested people using the mailing
+  feature from meetup.com.
+* Advertise the meetup on Twitter and mention
+  `@llvmweekly <http://twitter.com/llvmweekly>`_ and
+  `@llvmorg <http://twitter.com/llvmorg>`_.
+* Announce the next meetup in advance, and remind in one week or so.
+
+Tech talks
+----------
+
+* It’s a great idea to have several talks scheduled for several upcoming
+  meetups to get the ball rolling.
+* Keep looking for speakers far in advance, ideally you should have 2-3
+  speakers ready in the pipeline.
+* Try to record the talks if possible. It adds visibility to the meetup and
+  just a good idea in general. Any modern smartphone or tablet should work, but
+  you can also get a camera. Though, it is recommended to get an external
+  microphone for better sound.
+
+Where to host the meetup?
+-------------------------
+
+* Look around for bars/café with projectors.
+* Talk to tech companies in the area.
+* Some co-working spaces provide their facilities for non-profit (i.e., you do
+  not charge attendees any fees) meetups.
+* Ask nearby universities or university departments.
+
+How to pick the date?
+---------------------
+
+* Make sure you do not clash with the similar meetups in the city (e.g.,
+  C++ user groups).
+* Prefer not to have a meetup the same week when the other similar meetups
+  happen (e.g., it’s not a good idea to have LLVM meetup on Thursday after
+  C++ meetup on Wednesday).
+* Meetups on weekends may attract people who live far away from the city,
+  but the people who live in the city may not attend.
+* Make a poll, but beware that not every responder will join (we had ~20 votes
+  on the poll, while only ~8 people attended).
+

diff --git a/docs/index.rst b/docs/index.rst
index b03e6b7..97193db 100644 (file)
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -565,6 +565,21 @@ This channel has several bots.
 * clang-bot - A `geordi <http://www.eelis.net/geordi/>`_ instance running
   near-trunk clang instead of gcc.
 
+Meetups and social events
+-------------------------
+
+.. toctree::
+   :hidden:
+
+   MeetupGuidelines
+
+Besides developer `meetings and conferences <https://llvm.org/devmtg/>`_,
+there are several user groups called
+`LLVM Socials <https://www.meetup.com/pro/llvm/>`_. We greatly encourage you to
+join one in your city. Or start a new one if there is none:
+
+:doc:`MeetupGuidelines`
+
 Community wide proposals
 ------------------------