diff options
1 files changed, 72 insertions, 75 deletions
| -rw-r--r-- | src/blog/how-to-use-jira/cards.du | 147 |
diff --git a/src/blog/how-to-use-jira/cards.du b/src/blog/how-to-use-jira/cards.du index 8a5f1b7..a2bcb1d 100644 --- a/src/blog/how-to-use-jira/cards.du +++ b/src/blog/how-to-use-jira/cards.du @@ -1,161 +1,158 @@ -# Cards - How to use Jira +'def title Cards - How to use Jira +'def desc Each issue is represented as an object with properties. More specifically, these objects are called 'cards'. -'define expected-reading 4 min -'define created 24 July 2020 -'define edited 03 June 2021 -[$pagenav] +# {title} -'define start_link ./ -'define prev_link ./filters.html Filters -'define next_link ./projects.html Projects -[$pagination_middle] +{pagenav 4 min;24 July 2020;03 June 2021} + +{pagination ./;Filters;./filters.html;Projects;./projects.html} .contents .numbered -1. [url #properties Properties] -2. [url #creating Creating] -3. [url #viewing Viewing] -4. [url #how-to-use How to use] +1. {uhref Properties} +2. {uhref Creating} +3. {uhref Viewing} +4. {uhref How to use} .numbered - 1. [url #right-side Right side] - 2. [url #work-log Work log] - 3. [url #issue-flagging Issue flagging] - 4. [url #basic-issue-information Basic issue information] + 1. {uhref Right side} + 2. {uhref Work log} + 3. {uhref Issue flagging} + 4. {uhref Basic issue information} -[=Each issue is represented as an object with properties=]. More specifically, these objects are called 'cards'. +{b Each issue is represented as an object with properties}. More specifically, these objects are called 'cards'. -[image ./img/kanban-cards.png] +{img ./img/kanban-cards.png} ## Properties Each card has the following properties: -[image ./img/fields-cards.png] +{img ./img/fields-cards.png} :unordered -- [=Project=] - the [url ./projects.html project] this card is stored in +- {b Project} - the {url project;./projects.html} this card is stored in - [image ./img/project-create-card.png] + {img ./img/project-create-card.png} -- [=Issue type=] - the basic purpose of an issue (Improvement, Bug, ...) +- {b Issue type} - the basic purpose of an issue (Improvement, Bug, ...) - [image ./img/issue-types.png] + {img ./img/issue-types.png} :bulleted - - [image ./img/story-type.png Story] - functionality or feature expressed as a goal, something like "As a user, I want to be able to pay for my order via PayPal" + - {img Story;./img/story-type.png} - functionality or feature expressed as a goal, something like "As a user, I want to be able to pay for my order via PayPal" - - [image ./img/bug-type.png Bug] - a problem/error + - {img Bug;./img/bug-type.png} - a problem/error - - [image ./img/epic-type.png Epic] - a collection of issues, issues are linked through 'Epic link' (see below) + - {img Epic;./img/epic-type.png} - a collection of issues, issues are linked through 'Epic link' (see below) - - [image ./img/task-type.png Task] - a small piece of work + - {img Task;./img/task-type.png} - a small piece of work - - [image ./img/sub-task-type.png Sub-task] - an issue that is directly connected to another issue. This is used for when a given issue needs to be broken down into separate even smaller issues. + - {img Sub-task;./img/sub-task-type.png} - an issue that is directly connected to another issue. This is used for when a given issue needs to be broken down into separate even smaller issues. -- [=Summary=] - a (required) brief explanation of the issue +- {b Summary} - a (required) brief explanation of the issue - [image ./img/summary-create-card.png] + {img ./img/summary-create-card.png} -- [=Description=] - detailed explanation of the issue +- {b Description} - detailed explanation of the issue - [image ./img/description-create-card.png] + {img ./img/description-create-card.png} -- [=Reporter=] - person who created the issue +- {b Reporter} - person who created the issue - [image ./img/reporter-create-card.png] + {img ./img/reporter-create-card.png} -- [=Assignee=] - person who will work on the issue +- {b Assignee} - person who will work on the issue - [image ./img/assignee-create-card.png] + {img ./img/assignee-create-card.png} -- [=Labels=] - tags with which you can organise even more the issue +- {b Labels} - tags with which you can organise even more the issue - [image ./img/label-create-card.png] + {img ./img/label-create-card.png} -- [=Epic link=] - link of issue with type Epic +- {b Epic link} - link of issue with type Epic - [image ./img/epic-link-create-card.png] + {img ./img/epic-link-create-card.png} ## Creating -To create a card yourself, you need to [=press the [`Create`] button on the top bar=]. +To create a card yourself, you need to {b press the {` Create} button on the top bar}. -[image ./img/create-header.png] +{img ./img/create-header.png} ## Viewing -[=All=] cards (issues) can be viewed from a [url ./projects.html project]'s side menu, under 'Issues'. +{b All} cards (issues) can be viewed from a {url project;./projects.html}'s side menu, under 'Issues'. -[image ./img/issues-sidebar.png] +{img ./img/issues-sidebar.png} -Of course, they can also be viewed through [=[url ./filters.html filters]=] and a [=[url ./projects.html project]'s board=]. +Of course, they can also be viewed through {b {url filters;./filters.html}} and a {b {url project;./projects.html}'s board}. ## How to use -By default, opening a card presents, at the top, it's [=key=] (think of it as an ID), +By default, opening a card presents, at the top, it's {b key} (think of it as an ID), -[image ./img/card-key.png] +{img ./img/card-key.png} -it's [=summary=] below it, +it's {b summary} below it, -[image ./img/card-summary.png] +{img ./img/card-summary.png} -options for adding [=attachments=], [=subtasks=], [=linking issues=] and [=adding more apps=] (think of apps like extensions), +options for adding {b attachments}, {b subtasks}, {b linking issues} and {b adding more apps} (think of apps like extensions), -[image ./img/card-attach-subtask.png] +{img ./img/card-attach-subtask.png} -following are the [=description=], [=actual attachments=], [=subtasks=], [=linked issues=], etc., +following are the {b description}, {b actual attachments}, {b subtasks}, {b linked issues}, etc., -[image ./img/desc-att-sub-link.png] +{img ./img/desc-att-sub-link.png} -and at the bottom you have the [=activity=], consisting of [=comments=] on the issue, +and at the bottom you have the {b activity}, consisting of {b comments} on the issue, -[image ./img/activity-comments.png] +{img ./img/activity-comments.png} -[=history=] of things that have happened to that issue, +{b history} of things that have happened to that issue, -[image ./img/activity-history.png] +{img ./img/activity-history.png} -and [=work logs=] (a bit later we talk about them in more detail). +and {b work logs} (a bit later we talk about them in more detail). -[image ./img/activity-work-log.png] +{img ./img/activity-work-log.png} ### Right side -To the right side, you have all of the different [=properties=] (some fields without a value will be hidden). +To the right side, you have all of the different {b properties} (some fields without a value will be hidden). -[image ./img/card-right-side.png] +{img ./img/card-right-side.png} -On the top right you can change [=watch options=] ([url https://www.idalko.com/jira-watch-issues/ watching an issue] means you get notified by all changes done to it), you can [=share=] the card and do [=actions=] (the three dots). +On the top right you can change {b watch options} ({url watching an issue;https://www.idalko.com/jira-watch-issues/} means you get notified by all changes done to it), you can {b share} the card and do {b actions} (the three dots). -[image ./img/card-top-right.png] +{img ./img/card-top-right.png} -[=Actions=] are things you can do to the whole card, like moving or deleting it. +{b Actions} are things you can do to the whole card, like moving or deleting it. -[image ./img/card-actions.png] +{img ./img/card-actions.png} -The most notable options are [`[url https://confluence.atlassian.com/jirasoftwarecloud/logging-work-on-issues-902499028.html Log work]`] and [`Add flag`]. +The most notable options are {` {url Log work;https://confluence.atlassian.com/jirasoftwarecloud/logging-work-on-issues-902499028.html}} and {` Add flag}. ### Work log -In Jira, you can [=estimate how long an issue will take for it to be resolved=]. This is done through [=logging work=]. +In Jira, you can {b estimate how long an issue will take for it to be resolved}. This is done through {b logging work}. -In the [`Log work`] screen, you'll be met with a [`Time spent`] and [`Time remaining`] fields, that you'll need to fill with the appropriate information. +In the {` Log work} screen, you'll be met with a {` Time spent} and {` Time remaining} fields, that you'll need to fill with the appropriate information. -[image ./img/time-tracking.png] +{img ./img/time-tracking.png} -The time remaining takes a [=default=] value from the [=previous time log=], so you don't need to specify it every time. +The time remaining takes a {b default} value from the {b previous time log}, so you don't need to specify it every time. ### Issue flagging -A [=flagged issue=] is an issue that is very important. Flagged issues are displayed in yellow to signify their needed attention. +A {b flagged issue} is an issue that is very important. Flagged issues are displayed in yellow to signify their needed attention. -[image ./img/flagged-card.png] +{img ./img/flagged-card.png} ### Basic issue information -On the bottom right you can see [=when the issue was created=] and [=when it was last updated=]. You can also access the field configuration menu from the [`Configure`] button. It won't be covered in this tutorial, you can read about it [url https://confluence.atlassian.com/adminjiracloud/changing-a-field-configuration-844500798.html here]. +On the bottom right you can see {b when the issue was created} and {b when it was last updated}. You can also access the field configuration menu from the {` Configure} button. It won't be covered in this tutorial, you can read about it {url here;https://confluence.atlassian.com/adminjiracloud/changing-a-field-configuration-844500798.html}. -[image ./img/time-and-configure.png] +{img ./img/time-and-configure.png} |