Merge "[upstream] Updates to IRC Meetings Module"

doc/upstream-training/source/slides/howitsmade-communication.rst

@@ -0,0 +1,99 @@
+====================
+Online Communication
+====================
+
+.. image:: ./_assets/os_background.png
+   :class: fill
+   :width: 100%
+
+Ways to Communicate in OpenStack
+================================
+
+- Talking in IRC Channels & Meetings
+- Wiki Pages
+- Etherpads
+- Mailing Lists
+
+IRC Channels
+============
+
+- Each project and working group has its own channel
+- The common syntax: #openstack-<name-of-project>
+- Meeting channels (#openstack-meeting, #openstack-meeting-cp, etc.)
+- General discussion around what's going on in a project
+- Good place to get questions answered
+
+.. notes
+   There are a finite number of meeting channels so that meetings are
+   spread around. This is enforced by infra. The #openstack-meeting-cp
+   channel is special in that it is dedicated to cross project efforts.
+
+IRC Meetings
+============
+
+
+.. image:: ./_assets/06-01-irc-meetings.png
+  :width: 100%
+
+.. notes
+   Usually follow an agenda, more structured discussion than in the project
+   specific channel
+
+IRC Meetings List
+=================
+
+.. image:: ./_assets/06-02-irc-meetings-list.png
+  :width: 100%
+
+- IRC meetings: http://eavesdrop.openstack.org/
+- Others: https://wiki.openstack.org/wiki/Meetings
+
+IRC Logs
+========
+
+- Logs of meetings are archived so that they can be referenced later on
+- http://eavesdrop.openstack.org/
+
+Exercise 1
+==========
+
+Join the channel of the project(s) you are interested in and find the
+logs from the most recent meeting.
+
+Wiki Pages
+==========
+
+- Each project and working group also has its own wiki page
+    - https://wiki.openstack.org/wiki/Main_Page
+- Good source of info about when and in what channel regular meetings are held
+- Generally has information about who the PTL and cores are
+
+Exercise 2
+==========
+
+Look up when the next meeting is for the channel you joined and where
+the meeting is (#openstack-meeting, #openstack-meeting-3, etc).
+
+Etherpads
+=========
+
+- Common place to have people in a project collaborate on larger projects
+  and planning of events
+- No master list of etherpads - harder to find what you are looking for
+  without having looked at it before or without asking for the URL
+
+Mailing Lists (ML)
+==================
+
+- More than 40 different ML's
+- http://lists.openstack.org/cgi-bin/mailman/listinfo
+- Way for people to communicate to a larger group than those that
+  are on IRC
+- All emails are archived
+
+Exercise 3
+==========
+
+Look through the list of mailing lists and subscribe to at least
+one that would be most helpful for you and then locate where the archives
+for that ML are.

doc/upstream-training/source/slides/howitsmade-irc-meetings.rst

@@ -1,63 +0,0 @@
-============
-IRC meetings
-============
-
-.. image:: ./_assets/os_background.png
-   :class: fill
-   :width: 100%
-
-IRC meetings
-============
-
-.. image:: ./_assets/06-01-irc-meetings.png
-  :width: 100%
-
-IRC meetings list
-=================
-
-.. image:: ./_assets/06-02-irc-meetings-list.png
-  :width: 100%
-
-- IRC meetings: http://eavesdrop.openstack.org/
-- Others: https://wiki.openstack.org/wiki/Meetings
-
-Meeting agenda
-==============
-
-.. image:: ./_assets/06-03-meeting-agenda.png
-  :width: 100%
-
-Meetbot
-=======
-
-.. image:: ./_assets/06-04-meetbot.png
-  :width: 100%
-
-Exercise
-========
-
-Join irc.freenode.net#upstream-university
-
-#info
-=====
-
-Add an info item to the minutes. People should liberally use this for
-important things they say, so that they can be logged in the minutes.
-
-#action
-=======
-
-Document an action item in the minutes. Include any nicknames in the line, and
-the item will be assigned to them. (nicknames are case-sensitive)
-
-#help
-=====
-
-Add a "Call for Help" to the minutes. Use this command when you need to
-recruit someone to do a task. (Counter-intuitively, this doesn't provide help
-on the bot)
-
-Exercise
-========
-
-Lunch menu meeting

doc/upstream-training/source/slides/slide-index.rst

@@ -27,7 +27,7 @@ How OpenStack is Made
    howitsmade-metrics.rst
    howitsmade-release-cycle.rst
    howitsmade-technical-committee.rst
-   howitsmade-irc-meetings.rst
+   howitsmade-communication.rst
    branching-model.rst
 
 Workflow and Tools for Participation

doc/upstream-training/source/website/index.rst

@@ -110,7 +110,7 @@ How OpenStack is Made
 * `Metrics <howitsmade-metrics.html>`_
 * `Release cycle <howitsmade-release-cycle.html>`_
 * `OpenStack Governance <howitsmade-technical-committee.html>`_
-* `IRC meetings <howitsmade-irc-meetings.html>`_
+* `Communication <howitsmade-communication.html>`_
 
 Workflow and Tools for Participation
 ------------------------------------