diff --git a/llvm/docs/MeetupGuidelines.rst b/llvm/docs/MeetupGuidelines.rst new file mode 100644 --- /dev/null +++ b/llvm/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 `_. + +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 `_ 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 `_ and + `@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/llvm/docs/index.rst b/llvm/docs/index.rst --- a/llvm/docs/index.rst +++ b/llvm/docs/index.rst @@ -565,6 +565,21 @@ * clang-bot - A `geordi `_ instance running near-trunk clang instead of gcc. +Meetups and social events +------------------------- + +.. toctree:: + :hidden: + + MeetupGuidelines + +Besides developer `meetings and conferences `_, +there are several user groups called +`LLVM Socials `_. We greatly encourage you to +join one in your city. Or start a new one if there is none: + +:doc:`MeetupGuidelines` + Community wide proposals ------------------------