Add guidance for what to put in community calendar invites
authorKristof Beyls <kristof.beyls@arm.com>
Thu, 18 Aug 2022 12:58:05 +0000 (14:58 +0200)
committerKristof Beyls <kristof.beyls@arm.com>
Fri, 19 Aug 2022 12:11:33 +0000 (14:11 +0200)
Differential Revision: https://reviews.llvm.org/D132134

llvm/docs/GettingInvolved.rst

index 117c818..accc295 100644 (file)
@@ -147,6 +147,8 @@ The :doc:`CodeOfConduct` applies to all online sync-ups.
 If you'd like to organize a new sync-up, please add the info in the table\r
 below. Please also create a calendar event for it and invite calendar@llvm.org\r
 to the event, so that it'll show up on the :ref:`llvm-community-calendar`. \r
+Please see :ref:`llvm-community-calendar-host-guidance` for more guidance on\r
+what to add to your calendar invite.\r
 \r
 .. list-table:: LLVM regular sync-up calls\r
    :widths: 25 25 25 25\r
@@ -313,6 +315,8 @@ Guidance for office hours hosts
   information to the list above. Please create a calendar event for it and\r
   invite calendar@llvm.org to the event so that it'll show up on the \r
   :ref:`llvm-community-calendar`.\r
+  Please see :ref:`llvm-community-calendar-host-guidance` for more guidance on\r
+  what to add to your calendar invite.\r
 * When starting an office hours session, consider typing something like "*Hi,\r
   I'm available for chats in the next half hour at* video chat URL. *I'm\r
   looking forward to having conversations on the video chat or here.*" on the\r
@@ -424,3 +428,39 @@ also be seen inline below:
 .. raw:: html\r
 \r
     <iframe src="https://calendar.google.com/calendar/embed?height=600&wkst=1&bgcolor=%23ffffff&ctz=UTC&showCalendars=0&showDate=1&showNav=1&src=Y2FsZW5kYXJAbGx2bS5vcmc&color=%23039BE5" style="border:solid 1px #777" width="800" height="600" frameborder="0" scrolling="no"></iframe>\r
+\r
+.. _llvm-community-calendar-host-guidance:\r
+\r
+Guidance on what to put into LLVM community calendar invites\r
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\r
+\r
+Please put the following pieces of information in your calendar invite:\r
+\r
+* Write a single paragraph describing what the event is about. Include things\r
+  such as who the event is for and what sort of topics are discussed.\r
+* State explicitly that the :doc:`CodeOfConduct` applies to this event.\r
+* Make it clear who:\r
+\r
+  * the organizer is.\r
+\r
+  * the person to contact is in case of any code-of-conduct issues.  Typically,\r
+    this would be the organizer.\r
+\r
+* If you have meeting minutes for your event, add a pointer to where those live.\r
+  A good place for meeting minutes could be as a post on LLVM Discourse.\r
+\r
+An example invite looks as follows\r
+\r
+.. code-block:: none\r
+\r
+  This event is a meetup for all developers of LLDB. Meeting agendas are posted\r
+  on discourse before the event.\r
+\r
+  Attendees are required to adhere to the LLVM Code of Conduct\r
+  (https://llvm.org/docs/CodeOfConduct.html). For any Code of Conduct reports,\r
+  please contact the organizers, and also email conduct@llvm.org.\r
+\r
+  Agenda/Meeting Minutes: Link to minutes\r
+\r
+  Organizer(s): First Surname (name@email.com)\r
+\r