4. Communication and coordination¶
This section discusses the communication mechanisms and how to use them for distributed development and working remotely.
Attention
Also refer to the Development and Core Tool Policy section for the rules of the road for working with the communication and coordination tools described in this section.
4.1. Daily Scrum¶
The project used a daily scrum meeting to try to keep everyone on track and moving forward. As much as possible (without an officially trained “scrum master” to lead every meeting) team members were encouraged to answer three questions:
- What ticket(s) have you been working on?
- What ticket(s) will you be working on next?
- What is blocking your progress?
The goal is to keep the meeting to 15 minutes, so any longer discussions were deferred to a “tailgate” session after everyone has made their initial scrum contribution. The “tailgate” session may last much longer, sometimes running to over an hour (since some team members on the DIMS project were working remotely and it wasn’t possible to just “drop into to your office” for side-bar conversations).
Note
It is really hard to avoid these 7 Mistakes During the Daily Stand-up Meeting.
4.2. Remote Coordination¶
This section describes the tools used for coordinating work remotely, such as team coding, daily scrum, and weekly “standup” meetings.
We initially used Adobe Connect, though that was phased out because it was so unstable and difficult to use. Various other coordination tools were tested, with Skype and Google Hangout being the most compatible and useful (though each has its own issues.)
4.2.1. Using Google Hangout¶
4.2.1.1. Requirements¶
- Firefox (at least when running Ubuntu on developer laptops)
- A Gmail address
- Plugin for Google Hangouts and Google Talk
Note
For now, DIMS developers should keep their name and email address
in the file $NAS/users/user-data.txt
for this purpose.
4.2.1.2. Plugin Installation¶
- Go to http://www.google.com/tools/dlpage/hangout/download.html?hl=en
- Choose the “64 bit .deb (For Debian/Ubuntu)” option.
- Click the “Install Plugin” button.
- When the software installation dialog box opens, choose to open the file with the Ubuntu Software Center.
- Click the “Install” button on the upper right hand side of the next window that opens.
- You will be prompted for your password.
- The install should finish on its own.
4.2.1.3. When you make or join your first call¶
- In your Gmail window, all contacts you may chat with will be on the left hand side, unless you’ve changed your settings.
- Since we all don’t have each other’s addresses for Gmail right now, you won’t actually have any contacts.
- Whomever starts the Hangouts session can send a link via email to each member of a meeting.
- If you get an invitation via an email, click the link in the email, and a new window will open for the Hangout session.
- If whomever starts the Hangout session knows your email and adds you to the call, a box will pop up in the bottom right hand of your Gmail window. The top of this box will be highlighted green.
- Click the part that says you’ve been invited to a Hangouts video chat.
- There will be a pop up in the top left hand corner, pointing to a gray box to the left of the address bar.
- Click the gray box and choose “Allow” or “Allow and Remember” for the plugin to work during just the current call or for all calls, forever.
Note
If your sound or microphone settings are sounding funny:
- Check Ubuntu’s sound settings
- Make sure the speakers and microphone settings are using the appropiate option (i.e., the builtin hardware if you aren’t using headphones and vice versa).
4.2.1.4. Screensharing in Google Hangouts¶
These docs have been update to reflect the changes Google has made to Hangouts. There is an ‘original version’, and sometimes the ‘new version’ is finicky, and we must resort to the ‘original version’. As such, the instructions for the ‘original version’ will be preserved in the Google Hangouts ‘Original Version’ Screenshare Instructions
- Everyone can do it, at the same time!
- Hover your cursor in the top right hand corner of your Hangouts window.
- Click the option with the three vertically-aligned dots.
- A menu will drop down, choose
Screen Share
. - You can choose to share your whole desktop or individual windows of other applications you have open on your desktop. It doesn’t appear you can share all windows of an application, such as Terminal. If you have 5 Terminal windows open, you can only share 1 of them, unless you share your entire desktop. You can open multiple tabs, and those will be shared.
- Resizing of windows works just fine when screensharing also.
Caution
If two people are sharing the screen at the same time, and one of them puts the focus on the other person’s shared screen, you will put Google Hangout into a feedback loop that will eventually bring the internet to its knees. Don’t say I didn’t warn you!
4.2.2. Ops-Trust email lists¶
We use an instance of the Ops-Trust portal system for managing accounts and project email lists. Once an account is active, there are a number of mailing lists that DIMS project members should join to get various email communications (some ad-hoc and sent by humans, and some automatically generated for situational awareness, alerts, testing, etc.)
List | Purpose |
---|---|
dims-datafeeds |
Automated data feeds |
dims-demo |
DIMS demo mailing list |
dims-devops |
Continuous integration and syadmin notifications |
dims-general |
General Discussion |
dims-reports |
Periodic generated reports |
dims-test |
DIMS test mailing list |
dims-testeval |
Testing and Evaluation reports |
dims-vetting |
Vetting and Vouching |