How Does Team Discourse Use Discourse?Sarah Hawk March 4, 2018
As we claim on our website, we use Discourse as our primary team coordination tool to build… Discourse!
That means escaping email silos and minimising the number of disparate communication channels required to manage a fully distributed team. We are able to keep distractions like calls and meetings to a minimum and focus on actual work, while still feeling connected to the rest of the team.
When I first joined the Discourse team I found this way of working unusual. I was used to Trello, Google Docs, Basecamp, Zendesk, Todoist and Slack.
Most organisations I have worked in tried multiple permutations of every conceivable version the above. It took less than a week to rejoice in how unencumbered I felt to be rid of all those systems. I felt as righteous as I do after an epic spring cleaning session.
We do use Rocket.Chat for ‘quick answers’ between team members but that data is ephemeral and has no long-term value — as anyone on a free Slack plan knows. We push important long-term knowledge across into Discourse. We also make light use of Google Docs as shared permanent file storage, of which we don’t need a lot, but that’s it.
We run two Discourse instances:
- Our public facing Meta where we interact with the community, provide general support, and gather feedback.
- A private instance where we have internal discussions and house our internal knowledge base and runbooks.
But general discussion isn’t the only thing we use Discourse for.
We use Discourse to publicly manage our product roadmap. New feature requests are made by community members in the
features category by following this process. The requests are reviewed by our team and approved features are moved through the roadmap using tags for visibility.
- Tags to provide progress on feature requests.
- Discourse Assign to allocate work to team members.
We use a category on our internal instance of Discourse to manage tasks. New tasks are written up in the
todo category. In some cases they are immediately assigned and in others, we tag a group to give visibility of the task so that a team member can claim it using Discourse Assign. Once a task has been completed the topic is closed. We use topic timers to delete short or ephemeral todos when no record is required.
- Discourse Assign to allocate the job to a team member.
- Topic timers to close or delete topics once the task is complete.
- Tags to organise tasks into business groups.
We also use Discourse as a private email support portal which allows our entire team to share the support load. Anyone can email firstname.lastname@example.org and we handle those interactions in a central discourse mailbox, as private group messages.
Staged user accounts are set up, allowing us to store contact history against an individual. More details on how that works here.
This setup means that everyone has full visibility of the open tickets and can also easily search through past tickets, either to learn or to stay abreast of what has been discussed or promised.
People can jump in seamlessly across time zones. Discourse notifications alert us of incoming requests. We can tag people in when we need them, assign team members when a task needs to be completed, bookmark messages for follow up, set topic timers to nudge people and we can use whisper topics to support each other, make notes and troubleshoot as a team.
- Tags for private messages for organisation, similar to how labels work in Gmail.
- Discourse Presence means that we don’t accidentally reply to someone at the same time.
- Discourse Assign allows us to give or take ownership of a support issue.
- “Whisper posts” let us privately research or troubleshoot as a team, keeping all the relevant information within the topic.
Tip: Edit the post titles so that the message is identifiable by everyone at a glance.
We use Discourse as both a public and a private knowledge repository. The
howto category on Meta is a crowdsourced knowledge base which houses community written tutorial topics that describe how to set up, configure, or install Discourse using a specific platform or environment.
Internally we use our private Discourse instance to store run-books. They are a great way for employees in mismatched time zones to document processes so that other employees are able to be productive without having to wait for a response to a question.
- Subcategories for grouping similar topics
- Tags for categorisation
- Trust levels to restrict posting to more experienced Discourse users
We believe strongly in using Discourse to help us build Discourse, and we’re constantly improving both our process, and Discourse, to make it a better team collaboration tool.