It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

The Admin's tale - War of the Tags

 

tags.png

The admin is sure, you already noticed these little tags, you can (and should) add to your questions, discussions and articles here on our Community Platform. The main product and interest collections are represented as tags, but you can also add any tag you want and as much tags as you want to your questions and discussions.

What do you think - how many different tags did we collect over the last years here on the community and its preceding platforms? Incredible 20.0000 tags! A lot of them are used only once and also a lot of them were automatically generated by asking a question on a page on Atlassian's documentation. But no matter where they came from, there are too many of them to be useful. 

At the moment, we are fighting the "War of the Tags" - manually trying to identify tags, which

  • have a wrong spelling
  • do have nothing in common with the belonging question 
  • can be merged with other tags, e.g. if the only difference is an underscore instead of a dash
  • can be divided into already existing tags

At the time, this article was released, we killed already more than 5000 tags by looking at every single post and decide, whether the tag is needful or not. This takes a lot of time, we haven't thrown enough tags yet into the eternal fires of Mordor, the War of the Tags is not over, there is  a lot of work left.

What can you do?

Take care of your tags! Tagging your questions is important and needful. But always keep the basic question in mind:

"If I wanted to find my own question, would I really search for this tag?"

Would you really search for the words "gibberish" or "stagingtoproduction" or "wrong"? I don't think so.

So, here are some guidelines for using tags:

  • Always tag your question with the correct product or interest (this tag is set automatically, if you click on "create" in the context of the product / interest)
  • Also provide a tag "server" or "cloud" - this makes it much easier for us to answer your question
  • Separate parts of a composite tag with hyphens, not underscores or spaces. E.g.  use "test-automation" instead of "test_automation" or "test automation"
  • Don't put anything into one large tag - it's better to use some short tags than a long one, e.g. use "jira-server" and "api" and "gagdet" instead of "jira_server_api_gadget" (or have a look at the special tag added to this article for a very bad example)
  • Do not seperate anything with a hyphen, e.g. do not use the tag "web-site" instead of "website"
  • Do not change technical terms, e.g. classnames, spell them as they are written in the error log, without additional hyphens or underscores
  • Try to avoid present participles ("...-ing-Words") - e.g. use "vote" instead of "voting" 
  • If it's possible, use the singular form of a noun, e.g. "task" instead of "tasks" (and please don't use both tags, because one of them must be the right one...) 
  • Check the spelling of your tag. It's not the end of the world, if the spelling is not correct, but probably you've just created one more tag to remove for the Tag Cleanup Crew
  • Tag your question with the main topics, limit yourself to a small number of tags

But please, don't be discouraged now from tagging your questions. They are important, they help you and others getting good and fast answers.  

In the end, we will win the War of the Tags. One day, with your help, I'm sure.

----

Just for your interest: today is May, 8th, 2018 - and we reduced the number of tags to 5,200! Our main task is now: don't let this number grow again in an uncontrolled way! 

19 comments

Monique van den Berg Community Manager Feb 02, 2018

@Thomas Schlegel I am dying laughing at your third tag.

Cassie Mayes Community Manager Feb 02, 2018

Very helpful advice. Thanks for the tips!

Thomas Schlegel Community Leader Feb 02, 2018

Thank you, @Cassie Mayes - I'm glad, you like it! 

carolyn french Community Leader Feb 02, 2018

A lot of these points also apply to Confluence users and are good practices to follow. Plus the Marketplace has some great add-ons in the label management area for those admin out there...

The "underscore vs. hyphen in tags/labels" argument is more a preference, but once it's been standardized on an instance, it makes sense to continue with one (in Community's case, use hyphens!)

Susan Hauth Community Leader Feb 03, 2018

Fantastic Article...Thanks

LeKisha Boswell Community Leader Feb 23, 2018

Excellent feedback that I will actually use in the near future!

Scott Grieder Atlassian Team Mar 03, 2018

Great advice. Thanks for sharing!

Sebastien Jacques Community Leader Mar 05, 2018

Thank you @Thomas Schlegel for the guidelines.

Kimm Michaud May 08, 2018

Yes.  Great advice!

Daniel Holmes Jun 14, 2018

The ten commandments of tags.  I like it

Petrolene le Roux Jul 11, 2018

Ok, this is great feedback.  But It still gives me an error message around my question box saying I should use tags.  Nothing I do is accepted.

Thomas Schlegel Community Leader Jul 11, 2018

Hi  @Petrolene le Roux, if you create your question in the context of a product (click on "Explore" in the header and then select the product you want to ask a question for and then click on "Create"), the appropriate tag will be set automatically.

K Stevenson Jul 20, 2018

I'm with Petrolene, tags aren't 'sticking'.  It's pre-populated with 'jira', but it still won't publish as it tells me I need to enter tags.

Petrolene le Roux Jul 20, 2018

@K StevensonI submitted a different Q yesterday which worked.  I cannot remember on which browser I was when it didn't work - but maybe try a different browser.  I suspect that's why mine didn't work the first time - but cannot confirm it :-)

K Stevenson Jul 20, 2018

@Petrolene le Roux thanks, that worked!  I went into Chrome on my phone to get it to work.  Interestingly, it didn't work on IE11 or Edge.

Petrolene le Roux Jul 22, 2018

Great @K Stevenson!  Thanks for letting me know!

Billy Poggi Community Leader Aug 07, 2018 • edited

Woot!  Thanks for everything you and the community champions do!  

Love this tag by the way, is it okay if I use it on my stuff too... ?  ;)

[tag - 

this-is-a_completele_nonsense-tag-just-to-make-clear that correct tagging_is _essential

]

Thomas Schlegel Community Leader Aug 07, 2018

Hi @Billy Poggi - thank you!

Of course, feel free to use the world's most famous tag :-)

Tansu Akdeniz Community Leader Sep 19, 2018

@Thomas Schlegel Great article, thanks !!

Comment

Log in or Sign up to comment
Community showcase
Published in Feedback & Announcements

Release notes for May 15, 2019

Thank you to our experience team, as per always, for their hard work. (Here is a visual representation of the team: πŸ‘©πŸΌβ€πŸ’»πŸ•΅πŸ»β€β™‚οΈ πŸƒπŸ»β€β™‚οΈπŸ’ƒπŸ½πŸ§œπŸ»β€β™€οΈπŸ‘¨πŸΌβ€πŸ’»πŸ˜‡πŸ€΄πŸ»πŸ§šπŸ»β€β™€οΈ) New:  You can now see...

403 views 7 22
Read article

Community Events

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

Events near you