Skip to content

Commit dbdecd8

Browse files
committed
added sample queries and dashboard image
1 parent d1a0429 commit dbdecd8

7 files changed

+37
-21
lines changed

docs/boards/queries/example-query-charts.md

+37-21
Original file line numberDiff line numberDiff line change
@@ -16,17 +16,17 @@ ms.date: 02/06/2023
1616

1717
[!INCLUDE [version-lt-eq-azure-devops](../../includes/version-lt-eq-azure-devops.md)]
1818

19+
Query charts are a great way to visualize status and trends. Also, by adding several charts to a dashboard, you can quickly review all the important data you want to monitor for your team or project. With that in mind, consider addressing the following questions with your team:
20+
- *What are the most useful query charts for teams to create and monitor?*
21+
- *What charts will help us maintain backlog hygiene?*
22+
- *When creating trend charts, what time frame should I consider?*
1923

20-
What are some useful query charts for teams to create and monitor?
21-
22-
How to view total work done
23-
How to view remaining work -
24+
Not all teams have the same goals or tracking needs. However, teams that adopt Agile methods tend to routinely perform the following tasks. So consider the status and trend charts that will help your team perform these tasks.
25+
- [Triage incoming work](../sprints/best-practices-scrum.md#tips-for-successful-triage-meetings), ensure new work is well defined
26+
- Refine the backlog as described in [Backlog management ](../backlogs/best-practices-product-backlog.md)
27+
- Plan sprints and set sprint goals as described in [Scrum and best practices](../sprints/best-practices-scrum.md)
28+
- Conduct [daily standups](../sprints/best-practices-scrum.md#daily-scrum-meetings)
2429

25-
Create tasks and estimate work
26-
How to view all work items
27-
How to view work items I'm following
28-
29-
Query charts and Query widgets for dashboards, customizing widget tile.
3030

3131
<!---TIPS
3232
consider the time frame you want to monitor
@@ -39,6 +39,16 @@ Hi priority bugs
3939
Triage bugs
4040
Active bug trends
4141
42+
43+
How to view total work done
44+
How to view remaining work -
45+
46+
Create tasks and estimate work
47+
How to view all work items
48+
How to view work items I'm following
49+
50+
Query charts and Query widgets for dashboards, customizing widget tile.
51+
4252
## What status or trends should your team monitor?
4353
4454
Questions to answer
@@ -48,22 +58,29 @@ Questions to answer
4858
- What team, product, or organization goals need to be monitored
4959
- What recurring activities need to be done to maintain backlog hygiene?
5060
51-
<!--- What articles should link to this article?
61+
What articles should link to this article?
5262
- Does a change in Stack Rank count toward the Changed Date?
5363
64+
Tips: Pie charts versus Query count; can quickly see the types of work items
5465
-->
5566

5667

5768
## Maintain backlog hygiene
5869

59-
Here are a few tasks to review periodically, usually at the beginning or end of a sprint. Review this list for what makes sense for your team and organization goals.
70+
The following queries can help your team maintain a healthy backlog by ensuring that work is assigned Here are a few tasks to review periodically, usually at the beginning or end of a sprint. Review this list for what makes sense for your team and organization goals.
6071

61-
- Unassigned work items
62-
- Active work items not assigned to the current sprint
63-
- Incomplete work assigned to a past sprint
64-
- Stale work items, no changes made in the last 2 to 3 months (query by Changed Date)
65-
- Ill-defined work items such as no Story Points or Effort defined
66-
- Unparented work
72+
| Query focus | Query clause |
73+
|-------|--------------|
74+
|Work assigned to a sprint but not assigned to a team member| :::image type="content" source="media/example-queries/query-no-assigned-to.png" alt-text="Screenshot of Query Editor, Assigned To field is blank for current iteration.":::
75+
|Active work items not assigned to the current sprint | :::image type="content" source="media/example-queries/query-active-but-not-current-iteration.png" alt-text="Screenshot of Query Editor, Active but not assigned to current iteration.":::
76+
- Active work items assigned to a past sprint | :::image type="content" source="media/example-queries/query-active-past-iteration.png" alt-text="Screenshot of Query Editor, Active but assigned to a past iteration."::: |
77+
|Stale work items, no changes made in the last 2 to 3 months (query by Changed Date) | :::image type="content" source="media/example-queries/query-stale-work.png " alt-text="Screenshot of Query Editor, Active work not changed for past 3 months."::: |
78+
|Ill-defined work items, for example, ones with no Description, Acceptance Criteria, Story Points, or Effort defined| :::image type="content" source="media/example-queries/query-ill-defined-work.png " alt-text="Screenshot of Query Editor, Work with empty required fields."::: |
79+
80+
In the following image, all five query charts appear on a team dashboard. To add query charts to a dashboard, see [Add charts to a dashboard](../../report/dashboards/add-charts-to-dashboard.md#add-a-work-item-query-or-chart)
81+
82+
83+
:::image type="content" source="media/example-queries/dashboard-backlog-hygiene-query-charts.png " alt-text="Screenshot of Dashboard with five query charts added.":::
6784

6885

6986
## Example status charts
@@ -72,17 +89,16 @@ Here are a few tasks to review periodically, usually at the beginning or end of
7289
- **Active bugs**: Agile teams monitor their bug or technical debt and set goals to maintain the total number under a specific number.
7390
- **Active bugs by assignment**: Monitor bugs assignments across a team to support load balancing.
7491
- Active bugs by state
75-
- **Tagged work items**: Monitor tagged work to ensure the team is meeingt specific goals, milestones, or categories of work.
92+
- **Tagged work items**: Monitor tagged work to ensure the team is meeting specific goals, milestones, or categories of work.
7693
- **Blocked work**: How much work is currently blocked? You can query blocked work using a tag or custom field.
7794

7895

7996
## Example trend charts
8097

8198
- Bug trends over time by state (last 30 days)
82-
- Active work trends by state (last 30 days)
83-
- Unassigned work
99+
- Active work trends by state (last 30 days)
84100
- Newly added work over time
85-
- Velocity by distinct area path
101+
- Velocity by distinct area path
86102

87103
## Useful work tracking widgets and charts
88104

Loading
Loading
Loading
Loading
Loading
Loading

0 commit comments

Comments
 (0)