[upstream] Updates to IRC Meetings Module

There is a lot more to communication in the community besides just
IRC meetings. Not all projects have set meeting times and not all projects
use a single channel. The other primary form of communication besides IRC
is the different mailing lists. This patch adds information about the mailing
lists and removes some of the more verbose information about IRC Meetings that
people new to OpenStack don't need to know. This patch also renames the
module to 'Communication' since it now has content outside of just IRC meetings.

Change-Id: I0a02c49b3de622f08699e862ca38679479f70e7e

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

@@ -111,7 +111,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
 ------------------------------------