Jump to: navigation, search

Difference between revisions of "Meetings/CreateaMeeting"

(Take good notes: add a link to docs for OpenStack's meetbot fork)
(Choose when and where the meeting should take place)
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== Create a Meeting ==
+
= Create a meeting =
  
=== Choose when and where the meeting should take place ===
+
== Choose when and where the meeting should take place ==
To create a new meeting, you need a meeting time and a meeting venue. Meetings are conducted in [[IRC]] in [[Meetings|our publicly accessible and logged meeting channels]]. Currently we have four meeting channels.
+
To create a new meeting, you need a meeting time and a meeting venue. Meetings are conducted in [[IRC]] in [[Meetings|our publicly accessible and logged meeting channels]].
 
+
'''It is recommended stick to one of these channels''', for [http://docs.openstack.org/project-team-guide/open-community.html#public-meetings-on-irc good reasons].
* #openstack-meeting
 
* #openstack-meeting-alt
 
* #openstack-meeting-3
 
* #openstack-meeting-4
 
  
 
To find and book a meeting time, visit our [http://eavesdrop.openstack.org meetings log page]. You can either use the listed iCal feed to view all currently existing meetings in calendar format, or evaluate the wikipage by using Control-F in your browser to search for conflicts at a specific UTC time (the majority of meetings start at the top of the hour and continue for 60 minutes).
 
To find and book a meeting time, visit our [http://eavesdrop.openstack.org meetings log page]. You can either use the listed iCal feed to view all currently existing meetings in calendar format, or evaluate the wikipage by using Control-F in your browser to search for conflicts at a specific UTC time (the majority of meetings start at the top of the hour and continue for 60 minutes).
Line 13: Line 9:
 
If you find you have selected a time which has other occurrences on the wikipage, evaluate date and meeting channel to select a UTC time, date and channel that is available.
 
If you find you have selected a time which has other occurrences on the wikipage, evaluate date and meeting channel to select a UTC time, date and channel that is available.
  
=== Register the meeting ===
+
== Register the meeting ==
 
Go to our [http://git.openstack.org/cgit/openstack-infra/irc-meetings meetings repo] and clone a copy for yourself following our [http://docs.openstack.org/infra/manual/developers.html#getting-started development workflow]. Follow the instructions in the meetings repo to create a new yaml file which will hold the details of your meeting. Submit the patch to gerrit (details in the development workflow link) and once it is merged it will appear [http://eavesdrop.openstack.org here] and in the ical feed.
 
Go to our [http://git.openstack.org/cgit/openstack-infra/irc-meetings meetings repo] and clone a copy for yourself following our [http://docs.openstack.org/infra/manual/developers.html#getting-started development workflow]. Follow the instructions in the meetings repo to create a new yaml file which will hold the details of your meeting. Submit the patch to gerrit (details in the development workflow link) and once it is merged it will appear [http://eavesdrop.openstack.org here] and in the ical feed.
  
 
Creating a wikipage for your meeting agenda is helpful. [https://wiki.openstack.org/wiki/Meetings/InfraTeamMeeting Here] is an example.
 
Creating a wikipage for your meeting agenda is helpful. [https://wiki.openstack.org/wiki/Meetings/InfraTeamMeeting Here] is an example.
  
== Chair a meeting ==
+
== Chairing meetings ==
 
 
To chair a meeting, show up in the IRC channel a few minutes before the date and time selected. Look for the ''openstack'' bot, it will be responding to your meeting commands. If there is a meeting ahead of you, wait until they are finished by checking the channel's topic message: if there is a meeting in place the topic will look something like
 
 
 
:Using short lived feature branchs (Meeting topic: keystone)
 
 
 
And if there is no meeting in place, the topic will look like:
 
 
 
:OpenStack Meetings || https://wiki.openstack.org/wiki/Meetings
 
 
 
Try to begin and conclude your meetings on time, but be courteous to those ahead and following you, their meeting is important as well.
 
 
 
To start the meeting, issue the '''#startmeeting <meetingname>''' command, bearing in mind that [http://docs.openstack.org/infra/system-config/irc.html#starting-a-meeting the logs will be recorded and archived based on the '''<meetingname>''' you choose] - so be consistent with this meeting name in order to keep all your meeting logs grouped together in one place.
 
 
 
Once the '''#startmeeting''' command has been issued, the bot should start the meeting. If the bot doesn't respond to this command, ask for assistance in ''#openstack-infra''.
 
 
 
The meeting bot will also tell you what commands it responds to as soon as you start the meeting.
 
 
 
End the meeting with the "'#endmeeting"' command. The '"#endmeeting"' command takes no arguments. The bot will only listen to the chair of that meeting for the "'#endmeeting"' command for the 60 minutes following the "'#startmeeting'" command, after the 60 minutes have expired it will listen to '"#endmeeting"' from anyone.
 
 
 
All our meetings are logged at [http://eavesdrop.openstack.org eavesdrop.openstack.org]. Looking over logs and minutes of past meetings should show you the results of the various meeting commands so that your meeting minutes are output in a format that is useful to you and your team.
 
 
 
=== Take good notes ===
 
 
 
One of the advantages of holding meetings in IRC is that notes come easy. Whether you're chairing a meeting or just participating, use the meetbot capabilities to help the auto-generation of high-quality meeting minutes:
 
 
 
* Use the '''#topic''' command to set the current topic.
 
* The '''#link''' command is useful to add clickable URLs to the meeting notes.
 
* Use the '''#agreed''' command to mark that a consensus was reached on a particular point.
 
* To assign work items to someone use the '''#action''' command.
 
** For example, '''#action reed to annotate the wiki pages''' will be rendered on the meeting minutes as a bullet point of things to do.
 
* Use the '''#info''' command to summarise topics being discussed, for the benefit of the meeting minutes.
 
** Sometimes a discussion evolves rapidly during the meeting so people should add a summary of the topic being discussed; for example '''#info Jane summarized that the issues with the current setup are related to memory consumption'''. This will make the minutes very informative at first glance and those that want to have more details will be able to read the full logs.
 
* Use [http://docs.openstack.org/infra/system-config/irc.html#voting the voting feature] to enable participants to make decisions democratically.
 
  
Full [https://wiki.debian.org/MeetBot documentation of the upstream meetbot is on Debian's wiki], but there is also [http://docs.openstack.org/infra/system-config/irc.html#meetbot documentation on OpenStack's fork of meetbot].
+
Once you have done the above, you can read [[Meetings/ChairaMeeting|how to chair a meeting]].

Latest revision as of 20:11, 15 November 2018

Create a meeting

Choose when and where the meeting should take place

To create a new meeting, you need a meeting time and a meeting venue. Meetings are conducted in IRC in our publicly accessible and logged meeting channels. It is recommended stick to one of these channels, for good reasons.

To find and book a meeting time, visit our meetings log page. You can either use the listed iCal feed to view all currently existing meetings in calendar format, or evaluate the wikipage by using Control-F in your browser to search for conflicts at a specific UTC time (the majority of meetings start at the top of the hour and continue for 60 minutes).

If you find you have selected a time which has other occurrences on the wikipage, evaluate date and meeting channel to select a UTC time, date and channel that is available.

Register the meeting

Go to our meetings repo and clone a copy for yourself following our development workflow. Follow the instructions in the meetings repo to create a new yaml file which will hold the details of your meeting. Submit the patch to gerrit (details in the development workflow link) and once it is merged it will appear here and in the ical feed.

Creating a wikipage for your meeting agenda is helpful. Here is an example.

Chairing meetings

Once you have done the above, you can read how to chair a meeting.