Note: All Atlassian partners and vendors must adhere to the official Community guidelines.
So you have an announcement you’d like to share with the Atlassian Community — great! We have more than 3 million members with a wide array of expertise across our product suite. Here’s how to create a standout article that will appeal to the masses:
Step 1: Familiarize yourself with the content architecture on Community.
Product collections: A collection is just an online space for a particular topic or product. We have one dedicated to each product in the Atlassian suite, as well as interests like agile and off-topic.
Watch functionality: A great way to stay on top of the latest posts on a particular topic is to “watch” that collection. You decide what and how often. Example:
(To view a list of your current notifications, click on your avatar in the top-right corner of Community, select “Manage settings” and then click the “Notifications” tab.)
Proper permissions: To keep the quality of articles in the Atlassian Community high, only certain roles have clearance to write them: Atlassian Staff, Community Manager, Community Leader and those in our Atlassian Authors program. Vendors and partners can request article-writing permissions by commenting on this thread.
Community demographics: Keep in mind that the Atlassian Community is a global one. Expertise ranges from beginner to advanced, so it’s important to appeal to a broad range in your writing.
Step 2: Create an outline before you start writing.
Don’t bury the lede! Think about what your key takeaway(s) will be. Put yourself in your readers' shoes: Why should I, as a community member, care about this post? Example: At the end of this article, readers will understand how Trello can help them create an editorial calendar.
Once you have an objective or two, you can start building an outline to support your goal. Our Community content lead, Bridget, suggests bulleting out statements of the points you’d like to make, such as:
Trello allows for flexible list structure
Butler allows me to easily label content that needs to be ported to other boards
The Calendar Power-Up provides great visibility for other teams
Step 3: Decide on a format that aligns with the content.
Now that you have your list of points to hit, you have some choices to make about the format of your article. A standard essay format might make sense if you’re telling a customer story or sharing a use case. If the reader will have to follow instructions to get set up, consider different sections with headers or a numbered list.
Bonus points for rich content like:
Curating a list of questions in advance that you anticipate being asked shows that you’re proactive and may save you some future effort. This post about Atlassian for Visual Studio Code is a great example.
Step 4: Fine-tune the voice.
If an article is brilliant but no one reads it, was it really brilliant at all? The voice and tone of your article matter almost as much as the content because readability is crucial in conveying your objective! Write like you’re explaining your points to a friend or colleague, and care if they understand or not. (It can never hurt to send your piece to an actual friend or colleague to gut check.) Still unsure? Check out the Atlassian Community’s voice and tone guide.
Step 5: Hit the publish button.
Don’t feel like you have to go it alone. If you would like an editing eye before making it official, feel free to email Bridget at firstname.lastname@example.org anytime for feedback.
Step 6: Respond to comments in a timely manner.
Don’t be surprised if other users have questions or comments regarding your article. You should receive a notification by email if someone responds, or you can check your Community notifications. Keep in mind that your answers should be optimistic, inclusive and empowering. Acknowledge when opinions differ from yours, and celebrate when they’re aligned!
Inspiring A+ articles:
Erica MossCommunity Manager
Hello Community! Quick disclaimer: We are running a contest on Community (The Atlympics!) from July 23rd - August 8th of 2021. If you are interested in participating in this contest (prizes! ...
Connect with like-minded Atlassian users at free events near you!Find an event
Connect with like-minded Atlassian users at free events near you!
Unfortunately there are no Community Events near you at the moment.Host an event
You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events