Everett Toews

Helping you shave narwhals

Microsoft Teams Norms

18 Jan 2019

Face to face communication is essential. It’s a necessary and irreplaceable form of communication. Chat also has numerous benefits. However, it’s best to establish some norms around the use of chat to realize those benefits and avoid some of the pitfalls.

Note: I've been forced to use MS Teams for the past 6 months. I'm not a fan but I'm trying to make the best of it.

Overview

Here is a high level overview of those norms.

  • Be mindful of people’s time and attention.
  • Keep chats as public as possible.
  • Use common courtesy. “Please” and “Thank you” still go a long way.
  • Assume good intentions (tone doesn’t travel well over chat) and asynchronous comms.
  • Management must take care when to intervene (like any medium).

Details

These details are shamelessly borrowed from the GitLab Communication Handbook on Chat. I recommend reading through that doc, picking and choosing the ones that make the most sense for your org, and fitting them to your purpose.

  • If you use chat, please use a public channel and mention the person or group you want to reach. This ensures it is easy for other people to chime in, involve other people if needed, and learn from whatever is discussed. Only use direct messages if the discussion is truly private and of no interest to anyone else.
  • If you’re only referring to someone, but don’t actually need their attention, and want to spare them from getting notified, spell out their name normally without @ mentioning them.
  • If the subject is of value to the wider community, consider commenting on an existing user story or opening a new user story and linking to that story in a relevant channel.
  • Despite the instantaneous nature of chat, it should be considered asynchronous communication. Don’t expect an instantaneous response; you have no idea what the other person is doing.
  • If you must send a private message, don’t start a conversation with “Hi” or “Hey” as that interrupts their work without communicating anything. If you have a quick question, just ask the question directly and the person will respond asynchronously. If you truly need to have a synchronous communication, then start by asking for that explicitly, while mentioning the subject. e.g. “I’m having trouble understanding issue #x, can we talk about it quickly?”.
  • Do not feel obligated to respond to chat messages when you are not working.
  • Feel free to send a colleague a link to these guidelines if the communication in Teams should be done asynchronously.
  • If you are having a hard time keeping up with chat messages, you can update your preferences to have Teams email you all notifications. To change the setting, go to Profile > Settings > Notifications.
  • Please avoid using @team or @channel unless this is about something urgent and important. In chat try to keep the use of keywords that mention the whole channel to a minimum. They should only be used for pings that are both urgent and important, not just important. By overusing channel mentions you make it harder to respond to personal mentions in a timely manner since people get pinged too frequently.
  • If something is important but not urgent - like complimenting or encouraging the entire team - use email or post in the channel without @-mentioning the team.
  • If you are aware that your teammate is on vacation, avoid mentioning them in a high volume channel. It will be difficult to find the information or question when they return. If you need to ensure they refer back to the thread, ensure to send them a link to the relevant Teams message through a direct message.
  • It’s not rude to leave a channel. When you’re no longer interested in the conversations happening in a channel, feel free to leave it so it won’t distract you anymore.

Tips ‘n Tricks

Like any tool, it’s necessary to learn at least some of the tip ‘n tricks to be effective with it (and have a little more fun too).

  • Brief introduction to Microsoft Teams
  • General help can be found in Chat in Microsoft Teams.
  • There’s a web app available at teams.microsoft.com
  • Every chat in Teams starts in a thread. Be conscious of where you’re typing (especially if you’re in the mobile app) to make sure you’re responding to the right thread.
  • When writing a message, you can Use Markdown formatting in Teams.
  • To share code, use ``` to start a multi-line code block or ` to start an inline code snippet.
  • Don’t just share the output of a command/process, include the command/process that generated the output. Context is crucial to debugging!
  • Sharing code as a screen shot is grounds for mockery.
  • All keyboard shortcuts can be found under Profile > Keyboard shortcuts.
  • Use Shift+Enter to start a new line in a message rather than sending every line as a message (and a notification).
  • You can insert an emoji by typing a :
  • When your cursor is in the reply textbox, you can press the Up Arrow to edit your last message.
  • Share direct links to things when possible rather than vaguely describing how to access something.
    • e.g. “read my answer on pytest” rather than “just go to that question on pytest and look around for my answer”
  • Links expand to show a preview of the page. You can remove these previews by clicking the X in the top right corner of the preview.
  • If you hover your mouse over any message, a few icons appear in the top right corner. Use the thumbs up icon to agree with someone without sending another message/notification to the channel.
  • You can manage your availability status under Profile.
  • Manage your notifications (Profile > Settings > Notifications) carefully to avoid notification fatigue. Here’s one example of notification settings that can help you get started.