From eb769d8d59eef501aab6300064f05f7f1a3ed48b Mon Sep 17 00:00:00 2001 From: Kendall Nelson Date: Mon, 10 Oct 2016 13:17:05 -0500 Subject: [PATCH] [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 --- .../slides/howitsmade-communication.rst | 99 +++++++++++++++++++ .../source/slides/howitsmade-irc-meetings.rst | 63 ------------ .../source/slides/slide-index.rst | 2 +- .../source/website/index.rst | 2 +- 4 files changed, 101 insertions(+), 65 deletions(-) create mode 100644 doc/upstream-training/source/slides/howitsmade-communication.rst delete mode 100644 doc/upstream-training/source/slides/howitsmade-irc-meetings.rst diff --git a/doc/upstream-training/source/slides/howitsmade-communication.rst b/doc/upstream-training/source/slides/howitsmade-communication.rst new file mode 100644 index 00000000..d65b6e4d --- /dev/null +++ b/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- +- 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. diff --git a/doc/upstream-training/source/slides/howitsmade-irc-meetings.rst b/doc/upstream-training/source/slides/howitsmade-irc-meetings.rst deleted file mode 100644 index 0fb070ba..00000000 --- a/doc/upstream-training/source/slides/howitsmade-irc-meetings.rst +++ /dev/null @@ -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 diff --git a/doc/upstream-training/source/slides/slide-index.rst b/doc/upstream-training/source/slides/slide-index.rst index d8b5a1a2..c70dd500 100644 --- a/doc/upstream-training/source/slides/slide-index.rst +++ b/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 diff --git a/doc/upstream-training/source/website/index.rst b/doc/upstream-training/source/website/index.rst index 732b4131..76284dd4 100644 --- a/doc/upstream-training/source/website/index.rst +++ b/doc/upstream-training/source/website/index.rst @@ -111,7 +111,7 @@ How OpenStack is Made * `Metrics `_ * `Release cycle `_ * `OpenStack Governance `_ -* `IRC meetings `_ +* `Communication `_ Workflow and Tools for Participation ------------------------------------