Atlassian Community voice and tone guide Edited

Erica_Moss Community Manager Feb 04, 2019

Meeples- Jump in@2x.png

A healthy community is propped up by a handful of key components: shared values, a desire to learn, clear guardrails for participation and, perhaps most importantly, an environment where members feel welcome to share their questions and ideas.

In that spirit, we’ve compiled a list of real examples from the Atlassian Community that exemplify the voice and tone we encourage all members to adopt in order to create a space that keeps folks coming back for more!

What the Atlassian Community is

  • Optimistic

    Example thread from @Meg Holbrook:

    • “I love that you all did your own Summit - it looks like it was a great success! This is such an awesome idea.”

  • Inclusive

    Example thread from @Mary Ramirez

    • “Glad to have you back! I think a buddy system is a great idea. Especially if you become friends for life. Makes me think about how beneficial this would be to a newbie. I remember feeling uncomfortable asking my new boss my 100+ questions. But having a senior or native employee to partner with and bounce ideas from sounds more comforting.”

  • Empowering

    Example thread from @Thomas_Schlegel:

    • “Hi Michael,

      Pages in your Confluence are sorted alphabetically by default unless you start to sort them manually. Then the latest page is added as the last one in the tree.

      You can restore the default sort order by clicking on the "A-Z-arrow" again:”

      tone screenshot.png

  • Helpful

    Example thread from @Cameron_Eldridge:

    • General

      • Make it a habit of clicking the Calculate button every time you navigate back to your plan. Data may have changed while you were away.

      • Create a page template in your Confluence space to capture requirements for each Initiative. This will help ensure everyone has a good grasp on the scope of these big work items.

        • You can link these directly to your Jira issues.

      • Create an Initiative kanban board to track the progress of high level Portfolio items.

        • You can also create an Epic kanban board to show which Initiative each Epic is linked to.

        • Include the Parent Link field on the board's Card Layout to easily see parent Initiatives.

      Committing Plan Changes

      • Try not to leave an abundance of uncommitted changes in your plan. Hundreds of uncommitted changes can make it difficult to remember everything you adjusted if you haven't visited your plan in a couple of days.

      • Ensure changes made in one scenario don't overlap with changes in another scenario. Otherwise, you may end up with conflicts that prevent you from committing changes.

      Issues sources

      • Scrum teams should use boards as their issue sources to take advantage of their sprints and associated history.

        • Portfolio can calculate a suggested velocity for each scrum team based on the story points completed in previous sprints.

      • When using a single issue source in a plan with multiple teams, Portfolio often schedules work for the "incorrect" team. This is especially prevalent when teams don't have any members assigned to them.

        • Leverage the Portfolio Team field in your issues to avoid scheduling conflicts.

          • Share your plan's private teams so that you can designate them in Jira issues.

            • Of course, you'll need to add the Team field to all applicable issue screens.

          • Alleviate scheduling conflicts even further by creating a unique issue source for each team in your plan.

      Multiple Scenario Planning

      • Create at least two scenarios for your plan.

        • Ensure that one of them, such as "Live," always reflects your Jira data in its current state.

      • Title your scenarios based on their purpose.

        • Examples

          • Live

          • Sandbox

          • Grooming

          • Best Case

          • Release Shift

      Plan Permissions

      • Avoid giving too many users edit permissions of your plan. Committing changes back to Jira can be very dangerous.


      • Apply default estimates to unestimated work items to get them to show up on the timeline.

        • This is most helpful when used in Epics and Initiatives that don't contain any child issues.

      • Pay attention to the ranking of stories in your Backlog. Rank holds the most weight in Portfolio's scheduling algorithm.

        • Estimated issues not assigned to sprints will automatically be placed in fake, placeholder sprints (e.g. Sprint 1, Sprint 2, etc.) that only exist in Portfolio, especially when ranked low in the backlog.

          • As a result, the plan may appear to be overbooked. Re-rank those issues higher in the backlog, then assign them to a sprint if the overbooked schedule doesn't revert back to green.

          • If the schedule is still red, overbooking may be present elsewhere in the plan.


  • Solutions-oriented

    Example thread from @Nic_Brough__Adaptavist_:

    • “Good plan. But I'm afraid it's not as easy as it should be.

      There are loads of types of field in Jira as far as we humans are concerned:

      • System fields that Jira always has on issues. There are four broad groups of these

        • Structural ones that are not really fields - Project, issue type and status.

        • Non editable fields - created, updated

        • Mandatory system field - summary, resolution (ok, resolution is not mandatory, but you should treat it as a field you always have to think about, whatever your users say about how much they don't want to use it)

        • Optional system fields - assignee, reporter, environment, due date, comments

        • Note that applications and add-ons can add to those - Service Desk, Software and Portfolio will add things like Epic Link, initiative, request, yadayadayada

      • Custom fields

      However, the only system field I would bother analysing is "environment". The others are either too useful to get rid of, or you can't.

      So, to answer question 1: Go to Admin -> Issues -> Custom fields. That's the list of fields you want to look at (and tack "environment" on to the list)

      Question 2:

      For each field, run the JQL "<field> is not empty". This will return a list of all the issues with content for that field.

      This does not tell you a massive amount though. I find it far more useful to save each one as a filter, then go to a new dashboard and add a "filter statistics" gadget, using "project" as the statistic. This way, it tells you the number of issues using the field by project. Far easier to read, and can lead you to "hey, you guys are the only people using this field, how about we rationalise it" conversations.

      Question 3:

      Not hugely, but it can make searches a bit more frustrating for a user, if they assume that a field they see in their project exists in someone else's project.

      You won't get any technical gain from hiding fields, it just simplifies some of the views for users. If you want to make things a bit faster, change the field contexts, so they only belong to a sub-set of projects and/or issue types.”

  • Empathetic

    Example thread from @Jack

    • “Welcome to the Community. I'm not sure about your deleted post TBH so can't directly comment on that. As you may be aware the Community is largely comprised of users just like yourself, this includes me. I clearly get your frustrated and would like to see if there is anything I, or others in the Community, can do to help. I don't know that I can change your overall perspective on the tool as a whole or the company I would like to think maybe the Community can help w/ specific issues you may be having. If not then certainly reaching out directly to Atlassian Support might resolve the issue. With that said is there a particular issue w/ the product that you seek assistance with?”

What the Atlassian Community is not

  • Condescending

  • Passive agressive

  • Confrontational
  • Promotional

See something important that’s missing from the list? Add it in the comments section below.


Jack Community Leader Feb 04, 2019

great article Erica! Put this on the "things you need to consume before becoming a member" reading list. :-)

Like # people like this
Erica_Moss Community Manager Feb 04, 2019

Thanks, @Jack! Definitely required reading. 😎

Like Stephanie_Grice likes this
Bridget Community Manager Feb 04, 2019

**sets new home page**

Like # people like this
Erica_Moss Community Manager Feb 04, 2019



Like # people like this


LarryBrock Community Leader Feb 04, 2019

Thanks for putting this together @Erica_Moss - This is a great guide to help develop a positive environment by instilling a "think before you speak" mentality.  I agree with @Jack that this should be required reading before diving headfirst into writing, commenting, answering, etc. 😎

Like # people like this
Erica_Moss Community Manager Feb 04, 2019

Thanks, @LarryBrock! We have a guide internally that informs pretty much all of the copy we create, so it made a lot of sense to extend some best practices to the Community as well. Glad it's useful. 😄

Like # people like this
Scott_Theus Community Leader Feb 05, 2019

A great article @Erica_Moss!

You have examples of good answers to use as guidelines, could you also add an example or two of good questions? Often the tone and voice of a reply will mirror the that of the request, and some questions are easier to figure out because they have good information about the issue in them while others can be vague.


Like # people like this
Erica_Moss Community Manager Feb 05, 2019

@Scott_Theus Great point, Scott! @Thomas_Schlegel has actually written about this very topic — if you see anything that's missing, definitely feel free to add it in the comments. 😄

Like Stephanie_Grice likes this
mattjared Atlassian Team Feb 05, 2019

Great work @Erica_Moss!!! 

Like # people like this
Monique_vdB Community Manager Feb 05, 2019

This is fabulous! I love the examples you provided! ❤️

Like # people like this
Celina_Zamora Community Manager Feb 08, 2019

@Erica_Moss this is where it’s at. If there was a :queen emoji available, it would be bolded, underlined, and highlighted. Great resource and the examples are fire!

Like Erica_Moss likes this
Like Erica_Moss likes this
Pavel_Junek Community Leader Jul 22, 2019

Thank’s for your article, great job! 🙂

Like Erica_Moss likes this

Thanks Erica, this definitely helps.


I recently joined Atlassian community and am really excited not only to connect with great minds but also getting to know lot many things new from articles and discussions happening.

Thank you. 

Like Erica_Moss likes this
Erica_Moss Community Manager Sep 09, 2019

@Vinod_Ramadoss We're so glad you're here!

Like # people like this


Could anyone give us advise, we would like to install Jira community license on our AWS. Is that possible to use 1 Jira Community license for 2 server AWS with different production project separated?

Sri_Kumar_P Atlassian Team Jan 17, 2020

Hi @Erica_Moss ,

Great article 👌. And nice Examples too 🙂👍



Like Erica_Moss likes this

Awesome work @Erica_Moss !!!

Like Erica_Moss likes this
Emily_Koch Atlassian Team Jan 30, 2020

Great article @Erica_Moss ... and all the community members who are setting a good example!

Like # people like this
Erica_Moss Community Manager Jan 30, 2020

@Emily_Koch Thank you!

I think we have a really strong, healthy community here at Atlassian. Thanks to @Erica_Moss for providing guidance! 

Like # people like this
Erica_Moss Community Manager Feb 04, 2020

@Shawn Kessler Thanks, Shawn!

Respected all,May i join buddy  system.  what is the method  or way in which we go  and   my issue become solve.  I wanted to join buddy system and  also wanted to say thanks all of you who guided me.


Log in or Sign up to comment