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 ------------------------------------