Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
4,366,308
Community Members
 
Community Events
168
Community Groups

Meaning of Description, Summary, Text.. etc.

What is the field name for the "title" / "subject" of a task / epic / story etc...

i.e. what shows up just below the project and ID of the object?

 

Documentation is not helpful because it does not define terms but rather just uses the term being defined in the sentence.

 

For example, looking at the "field reference":

 

Description:

Search for issues where the description contains particular text.

 

And then, for Summary:

Summary:

Search for issues where the summary contains particular text

 

Those two definition are useless... yeah, a Description is a description; but, what part of the task, epic, story, etc.. is the Description vs the Summary etc..

 

Please update documentation to be more helpful.

 

AND,... WHAT is that text at the top of an object? what is that called?

2 answers

1 accepted

2 votes
Answer accepted

Hi Nicolas,
I understand that you are having some confusion in identifying which field on your screen is named "Summary". 

Using your image, I've identified some of the fields you were concerned about:

storecore.png


I reviewed the existing documentation explaining the fields and can see that you are correct, there is no easy diagram explaining which unlabelled item on the screen is which field.

What is an issue? | Jira Software Cloud | Atlassian Support
Create an issue and a sub-task | Jira Software Cloud | Atlassian Support
Update an issue's details | Jira Software Cloud | Atlassian Support

I have logged an internal request referencing this question, and asked for more clarity in the documentation.


Hope that helps.
Regards
Heidi
Atlassian Support.

2 votes

The system field names have been chosen to try to be as close to an explanation of what they're for as possible with a short phrase.

In most cases, I can't really explain it any other way, but working through your list:

  • Summary:  A summary of what the issue is about, a short phrase to give you an idea of what the issue is about
  • Description:  Literally, a description of the issue
  • Title: not a standard field, you'll need to ask your admins.  Some people sometimes call the summary a title, but that's not what title means in English.  You probably want to dump this and use the summary.
  • Subject: not a standard field, you'll need to ask your admins.  Probably another synonym for summary in Jira, but a much better synonym than title. But you still probably want to dump this and use the summary.

If you're still stuck on what the fields are for, I can't go any better than "look up Summary and Description in a dictionary"!

ah; yes, a dictionary. I know what this is.


I am not asking "what does the word 'summary' mean in the English language?"

I am asking, "in Jira, the field named 'Summary' is used where on the JIRA UI page and how? When I look at a task / bug / epic etc... on the JIRA page, WHERE is the Summary? And for that matter, Where is the Title? Is there a Subject?"

See a sample JIRA task

SampleJiraDiscussion.png

 


So, now, with this context....


What is the Summary? the Title? The Subject? etc..

Maybe the documentation should explain that - what each part of the Jira form is called. I do not need the definition of the English word. I can use a dictionary.

Thank you,

Nicolas

Like David Wolfman likes this

Ok, so lets focus on  "In Jira, the field named 'Summary' is used where on the JIRA UI page and how? When I look at a task / bug / epic etc... on the JIRA page, WHERE is the Summary? And for that matter, Where is the Title? Is there a Subject?"

The field summary is usually used to contain a summary of the issue. 

On a Jira page, it appears where you have pointed to in your screenshot, quite prominent because it's the summary and hence what most humans will want to talk about if there's any need to discuss the issue.

Title and Subject are different things to a summary, the words mean different things.  Jira does not have a title or subject field (unless you deliberately add one)

Also "Maybe the documentation should explain that - what each part of the Jira form is called."

It does. It describes the field "summary" as the summary.  Description is described as a description,  The other system fields have names that tell you what they are for.

My feeling here is that you are not asking us the right question.  I can not work out what you are looking for.  You've asked twice about title and subject and I've told you that these are things you are making up (or your admins have added and not explained to you).  I do not know what you are looking for when you ask what a summary is or where it is - it's a summary and it's on screen where most people would expect to see it.  I do not know what more I can tell you about a summary being a summary.  

Like Jennifer Taylor likes this

How fun, Atlassian chooses how the English language works now. A summary could also be considered a title or description. Also funny that a Google search brought me here when I was also was searching for more context as to what Atlassian considered each field to mean. Good times. I wonder how many hits this page sees from people searching for similar things via Google. I agree with the OP on this post. Thanks for your replying though... By default there is no 'title' or 'subject' field and we are looking for "Summary" as the correct field for the big and bold "Title" of each Jira "Issue".

>How fun, Atlassian chooses how the English language works now.

No, English chooses how the language works.

Look in a dictionary for any country that has English as its first language (I could be grumpy about this and point out that it's only really England's dictionaries you should read, as the USA, Canada, Australia, and New Zealand all bastardise it a bit, but it still stands).  You will find that summary, title and description have different and distinct definitions.  And Atlassian have followed them with Jira.

Suggest an answer

Log in or Sign up to answer